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Cooking à la Elektor 


You've probably had the same experience: You have a great idea for your own development, and 
discover that someone else has already done a lot of the groundwork. Most of the time, it’s not 
worth reinventing the wheel. Instead, you can fall back on ready-made software and hardware 
modules, and connect them (after some customization) to get anew application running. For this 
issue’s main project, my colleague Mathias Claussen went this route (page 6). His LoRa sensor 
node can collect measurement data in the field and pass it on over long distances. He can use it for 
environmental data collection as well as home automation. The ingredients he used included: a 
Raspberry Pi Pico with a temperature sensor connected, a LoRa module from SeeedStudio, a LoRa 
MicroPython library, The Things Network as a cloud platform, and the automation framework 
Node-RED, which can be installed on a Raspberry Pi or PC. In typical Elektor style, we present 
not only the end result, but a kind of cooking show, so you know what's going on and can adapt 
or refine the recipe according to your preferences. The whole thing is served on a breadboard, 
but if you'd rather have a circuit board, you'll find the necessary data for that, too. 

It is also Elektor's style to offer not only opulent menu selections, but also lighter fare. If you are 
still new to MicroPython, I recommend the article on page 92. A small ESP32 board is sufficient 
for taking your first steps. And starting on page 30, you learn how to use the aforementioned 
Pico to switch an LED from a smartphone. 


Stay tuned and stay healthy! 


ELEKTOR @ 60: MORE TO COME! 


Elektor will celebrate 60 years of publishing and electronics innovation 
with a few exciting special projects. We are working on an anniversary 
book, a movie, a live event (World Ethical Electronics Forum), and the 
“Elektor mobile home lab.” We bet you are curious. Stay tuned for 
more info in the coming weeks. Have ideas for other special projects? 
Send me your thoughts: denise.bodrone@elektor.com! 
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Raspberry P1 Pico 


Fun with MicroPython 


By Mathias ClaußBen (Elektor) 


Using a Raspberry Pi Pico with MicroPython 
is a beginner-friendly way to program. 
Adding a SeeedStudio RFM95 LoRa 

module and a DS18B20 temperature sensor 
can create a quick LoORaWAN node with 
MicroPython. And as putting components 
only on breadboards may be a bit instable, a 
suggestion for a PCB is included. 
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Figure 2: RFM95 module. 
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The Raspberry Pi Pico (Figure 1) is anew microcontroller board, featur- 
ing the RP2040. This chip is designed and developed in-house by the 
Raspberry Pi Foundation and therefore it is their first silicon. After seeing 
all the news around it — and after hearing about some of the doubts and 
fascination with it — | figured it was time to get some projects started. 
The board offers no Wi-Fi but can be run on a set of batteries for porta- 
ble applications, so why not combine the Raspberry Pi Pico with a LoRa 
modem? The HOPERF RFM95 (Figure 2) is a well-priced and widely 
supported module that has been used in former Elektor projects, like 
My First LoRaWAN [1]. While in this article an STM32 BluePill module 
was used, this time we will go with the Raspberry Pi Pico. 


What we will build is a simple temperature measurement device using 
a DS18B20 sensor that will transmit data to a LoRaWAN gateway which 
will forward the data to The Things Network Cloud. From there we 
will grab the data with a (classical) Raspberry Pi running the (home) 
automation platform Node-RED. 


We will build the temperature sensing LoRa node on a breadboard, but if you 
prefer a PCB instead, this article will provide a draft one, done with KiCad. 


Figure 3 gives you the dataflow from the Raspberry Pi Pico over the 
LoRaWAN to The Things Network server. As you can see, a gateway is 
in the middle, translating the RF data into something that can be trans- 
ported over the Internet to The Things Network. The data delivered to 
the The Things Network shall be processed as we are interested in the 
temperature transmitted. To do so, we need to grab this data and are 
going to present It on a small web page. Figure 4 shows the dataflow 
from The Things Network to a Raspberry Pi that will generate a web 
page with the actual transmitted temperatur and also a chart indicating 
the last transmitted values. 


The software used to grab the data form The Things Network and gener- 
ate a web page Is Node-RED. Node-RED is a tool that allows to build 
graphically data flows and process various data. This can be done just 


by using a browser of choice — you only need to install the Node-RED 
server and just open a browser to get started. Node-RED has been 
used in Elektor projects in the past and allows a quick entry into data 
processing and handling. A Node-RED beginner book can be found at 
the Elektor Store. (See Related Products for more information.) 


The ingredients for this project are simple and can be seen in the textbox 
Required Material. Also make sure you are in a range of a LoRaWAN 
gateway that will route your data to The Things Network. If you do not 
have one In range but want to start with your own gateway, providing 
better LoRaWAN coverage, have a look at [3]. This is an all-in-one 
solution you can buy off the shelf. As an alternative, you can build your 
own Raspberry Pi based gateway with [4]. 


Bread Board First 

To demonstrate the basic schematic that we are going to build, it will 
be set up first on a bread board. This allows for fast testing, and as you 
can see, can be done with some simple wiring (Figure 5). To connect 
the LoRa modem to the Raspberry Pi Pico, we need four connections 
for the basic SPI interface: MOSI, MISO, SCK and CS (data in, data 
out, clock and chip select). This will allow for data exchange with the 
LoRa modem. In addition, RESET and DIOO are requiered to control 
the modem. DIO1 to DIO3 are connected and required by some other 
LoRa libraries, like the LMIC library (if we are going to program the 
Raspberry Pi Pico in C/C++). We can choose from one of the SPI ports 


Forward to internet 
cloud server 


— as AN 
LoRaWAN ‘The Things / 
Gateway iP Network ; 


RF transmission 


Figure 3; Dataflow to The Things Network, 


Required Material 

Raspberry Pi Pico * 

RFM95 * 

Bread board set * 

9 jumper wires male-male 
Breakout Board for RFM95 

2x20 pin header + 2x8 pin header 
DS18B20 temperature sensor 

10 cm copper wire (1 mm diameter) 


Vv VV VN VY VY VY VY 


Parts marked with * can be ordered 
at the Elektor store, pls see Related 
Products. 


For the breakout board Gerberfiles 
are provided [15] at your preferred 
PCB service. 


Figure 5: Schematic how to attach 


components. 


the Raspberry Pi Pico offers and connect it to the RFM95 LoRa modem. 
Also, we just need to connect RESET and DIOO from the module to any 
of the GPIOs of the Pico. To get a fully operational LoRa modem, also 
an antenna needs to be attached. 


For the antenna, we are going to use simple wire. A piece of copper wire 
with a diameter of 1 mm is perfectly sufficient. The required length is 
calculated as A/4 antenna for the 868 MHz, the range in which the LoRa 
module operates, as follows A/4 = (C)/868 MHz)/4 = (299792458 m/s)/ 
(868000000 1/s*4) = 0,08635 m = 8,635 cm. This length applies if wave 
would propagate in vacuum, but in copper the speed of the wave is lower 
and a shortening factor must be considered. With the value 0.95, you get 
an approximation with a length of 8.2 cm at the end for the copper wire. 


While not recommended, the pull-up on the reset-line has shown in the 
past to be required. It is added for a more stable operation, as RESET may 
pick up noise from the flying wires and reset the module unexpected. 
If you are working on your own LoRa board, it might be safe to place a 
pull-up, not populate it, and then later patch it to your board by hand. 


For the temperature sensor, a One-Wire connection will be used. As 
the name One-Wire indicates, we will need only one GPIO pin for the 
data exchange. The protocol can be implimented as a pure software 
solution so any GPIO pin is suitable to be used. One-Wire requires 
a pull-up resistor to be present. Depending on the MCU used, this 


© The Things 








| 
| Raspberry Pi 
— Network \ / (> TNO cnn | 
MQTT r Node-RED 
connection generated 
Web page 


Figure 4: Dataflow from The Things Network to User web page. 
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Figure 6: Setup on a breadboard. 
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Figure 8: Raspberry Pi Pico in bootloader mode. 


can be either an internal one, provided by the GPIO block inside your 
MCU, or an external one. To have a reliable data transfer an external 
pull-up resistor is prefered. 


If all the hardware is set up, it will look like what you see in Figure 6, 
so we can start coding. 


MicroPython and LoRa 

As using C/C++ for LoRa has been shown in other projects, this time 
we are going to choose MicroPython. As the Raspberry Pi Pico is a 
well-suited board for education, using MicroPython will make things 
even a bit easier. If you are new to MicroPython on the Raspberry 
Pi Pico, take a look at Gareth Halfacree and Ben Everard’s book, 
Get Started with MicroPython on Raspberry Pi Pico (Raspberry Pi 
Foundation, 2021). If you would like to get a paper copy, head over 
to the Elektor store [5]. If you would prefer an E-Book, grab a free 
English copy at [6]. 


Using LoRa and MicroPython has been done on other platforms but 
introduces some addtional challanges. MicroPython is an interpreted 
language like BASIC was on the C64 or other home computers. While 
this allows easy access, it leads to some CPU overhead during execu- 
tion and thus some limitations. 


The library we are going to use is a slightly modified version of uLora 
by fantasticdonkey found on GitHub at [7]. This library itself is a fork 
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Drag and drop MicroPython 


You can program your Pico by connecting it to a computer 
via USB, then dragging and dropping a file onto it, so weve 
put together a downloadable UF2 file to let you install 
MicroPython more easily. 


1. Download the MicroPython UF2 file by clicking the 
button below. 

2 Push and hold the BOOTSEL button and plug your Pico 
into the USB port of your Raspberry Pi or other 
computer. Release the BOOTSEL button after your Pico 
is connected. 

3. k will mount as a Mass Storage Device called RP|-RP2 

4. Drag and drop the MicroPython UF2 file onto the RPI- 
RP2 volume. Your Pico will reboot. You are now running 
MicroPython. 


You can access the REPL via USB Serial. Our MicroPython 
documentation contains step-by-step instructions for 
connecting to your Pico and programming it in 
MicroPython. 


Download UF2 fille —> 





Figure 7: MicroPython download for the Raspberry Pi Pico. 


Thonny 3.3.4 


https://thonny.org 


Ubuntu 20.04.1 LTS (64-bit) 
Python 3.7.9 (64 bit) 
Tk 8.6.10 


Made at the 
University of Tartu, Estonia, 
with help from the 
open-source community, 
Raspberry Pi Foundation 
and Cybernetica AS 





Copyright (©) 2021 Aivar Annamaa 
is ‘am comes with 
ABSOLUTELY NO WARRANTY! 
It is free software, and you are welcome to 
redistribute it under certain conditions, see 
https jicenses/MIT 


Figure 9: Thonny 

installed in version 
-orgji 

for details 3.3.4. 











of the TinyLoRa library for CircuitPython by Adafruit. The limitations 
mentioned are that we can only transmit data, but will be unable to 
receive anything back from the LoRaWAN. With this limitation, we also 
needed to use APB (activation by personalization) for authentication, 
meaning that the network session key and application session key 
are stored inside our code. 


As this is an example to show that you can do LoRa with MicroPython 
on the Raspberry Pi Pico, it is not perfect, but it can be done quickly 
to get started. The modified files needed can be downloaded from the 
Elektor GitHub page [12]. Also note that even if seems to be working 
software, stability might be an issue that needs to be addressed at 
some point. 


Getting MicroPython on the Raspberry Pi Pico 

The Raspberry Pi Pico comes with an included bootloader that makes 
it easy to swap the running firmware on it. As we are going to use 
MicroPython, we will install the latest version available from [8] as you 
can see in Figure 7. Download the UF2 file form the webpage and 
prepare your Raspberry Pi Pico to enter bootloader mode. 


To enter bootloader mode, disconnect the Raspberry Pi Pico, press 
the BOOTSEL button and reconnect it to your computer. It shall now 
a new mass storage device show up, like you see in Figure 8. Drag 
the downloaded UF2 file into this drive, so MicroPython in its current 
version will be installed. 


After a reboot you will be read to go, or at least your Raspberry Pi Pico 
will be. For development, having an editor or IDE would be beneficial. 
The next step is the setup of Thonny as Python IDE. 


Get Thonny in Place 

Installing the Thonny IDE on a recent Ubuntu 20.04 or even Windows 
takes just a few clicks. For Windows, you can grab an installer at [9]. 
For Ubuntu, you can use wget -q -O - https://github.com/thonny/ 
thonny/releases/download/v3.3.4/thonny-3.3.4.bash to get the installer 
for version 3.3.4 with support for the Raspberry Pi Pico. After the file 
has been downloaded, you can run it with bash thonny-3.3.4.bash. If 
the installation succeeds, you will have the Thonny IDE in version 3.3.4 
installed, as you can see In Figure 9. 


After its first start, we need to configure the Raspberry Pi Pico. This is 
done from the menu with Tools > Options and will open the configura- 
tion dialog like you can see in Figure 10. When the tools and hardware 
are in place, It's time for some code. 


Get the Code in Place 
For LoRa, it is important to know in which region of the world you 
are. AS an ISM Band is used, It may be in the 433 MHz, 868 MHz or 


Thonny options x 


General Interpreter Editor Theme & Font Run & Debug Terminal Shell | Assistant | 














Which interpreter or device should Thonny use for running your code? E 
| MicroPython (Raspberry Pi Pico) N 
Details 











Connect your device to the computer and select corresponding port below 
(look for your device name, "USB Serial" or "UART"). 

If you can't find it, you may need to install proper USB driver first. 

Port 


| Board in FS mode - Board CDC (/dev/ttyACMO) -| 











Install or update firmware 


| Cancel l 


Figure 10: Connection setting for the Raspberry Pi Pico. 














testnode 


ID: testnode 


* Last seen 47 seconds ago 456 13 
Overview Live data Messaging Location Payload formatters General settings 
Time Type Data preview 


\ 07:27:17 Schedule data downlink for transmissi.. DevAddr: 


Ñ 07:27:17 Forward data message to Application S.. DevAddr: 
Ñ 97:27:17 Forward uplink data message DevAddr: 
DevAddr: 


M 07:27:17 Receive uplink data message 


A 07:27:17 Successfully processed data message DevAddr: FCnt: 





“4. 07:27:16 Receive data message DevAddr: : FCnt: 


Figure 12: Received data inside the TTN console. 


MAC payload: 


MAC payload: 


MAC payload: 





915 MHz range. For Europe, it is mainly 868 MHz. It is 915 MHz if you 
are in the US. As this project will be developed within the European 
region, it will use the 868 MHz band plan, so if you rebuild it, be sure 
to change it to your region. As the uLoRa Is patched to be used on 
the Raspberry Pi Pico, you need to open and save ulora.py, ttn_eu.py, 
ulora_encryption.py and lora.py to your Raspberry Pi Pico through 
the Thonny IDE. For the ttn_eu.py, if this one is not applicable to your 
region, you need to save the corresponding ttn_xx.py to your board. 
This will provide the board with the required libraries, and a basic 
example we are going to explain now. 


Inside the /ora.py resides the main logic for this project. The program 
flow is shown in Figure 11. After the initialization, a temperature sensor 
attached to our One-Wire bus is searched for. If none is present, after 
120 seconds of sleep, a new attempt will be done to find one. If a sensor 
is present, its temperature will be read and afterwards transmitted. 
The way the value is encoded is not very efficient in terms of payload 
but will be later good for demonstration. Figure 12 shows the trans- 
mitted data inside The Things Network console. After a transmission, 
we need to wait for 900 seconds to comply with the fair use policy of 
The Things Network. If you like to start your code automatically on 
your Raspberry Pi Pico, save the /ora.py as main.py. 


Figure 11: 
Flowchart 
for data 
transmission. 
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Add application 


ees eet mee E Owen C Appicawes gf Gateway SS Organisations 





Owner™* 
Welcome to the Console! 
. . * 
Gat started nght away by creating an application or registenng a gateway, Application ID 
Need help? Have a look at our BM Docunentalon S of Get Support & 


Application name 








A 
Description 
This is for various testnodes from some of our projects 
Create an application Register a gateway 
i i i Optional application description; can also be used to save notes about the application 
Figure 13: Create a new application. 
Figure 14: Wizard to add a new application. 

t) nodes 

on ID: nodes 
A 1Enddevice 2% 1 Collaborator OF 1APIkey 
General information * Live data See all activity > 
Application ID C] 
Created at Feb 22, 2021 13:10:53 

Waiting for events from 

Last updated at Feb 22, 2021 13:10:53 


End devices (1) Q =+ Import end devices + Add end device 


Figure 15; Add new device, 


Register end device From The LoRaWAN Device Repository Manually 


From The LOR3WAN Device Repository Manually 


Preparation 
1, Select the end device 
Activation mode © * 


Over the air activation (OTAA) 
[ome | 


® Activation by personalization (ABP) 


Your end device will be added soon! 





@ = We're sorry, but your device is not yet part of The LoRaWAN Device Repository. You can use manual device registration, using the information your end device manufacturer ae 
provided e.g in the product's data sheet. Please also refer to our documentation on I Adding Devices B . Do not configure activation 
LoRaWAN version Ô * 
MAC V1.0.2 
2. Enter registration data The LoRaWAN version (MAC), as provided by the device manufacturer 
Please choose an end device first to proceed with entering registration data Network Server address 
eul.cloud.thethings.network 
J 
Application Server address 
eul.cloud.thethings.network 


Figure 16: Wizard to create a new node. 


Figure 17: Settings for ABP mode. 
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From The LoRaWAN Device Repository Manually 





Basic settings Network layer settings 
End device ID's, Name and Frequency plan, regiona 


Description parameters, end device 


End device ID * 


node 


DevEUI® 
The DevEUI is the unique identifier for this end device 
End device name 


End device description 


Optional end device description; can also be used to save notes about the end device 


Figure 18: Settings for name and EUI, 


& Network layer settings Application layer settings 
Frequency plan, regional keyt 
parameters, end device encrypt/decrypt LoRaWAN 


class and session keys. payload. 


Frequency plan © * 
Europe 863-870 MHz (SF9 for RX2 - recommended) 


The frequency plan used by the end device 


LoRaWAN version © * 


The LoRaWAN version (MAC), as provided by the de 
Regional Parameters version Ô * 
Select... 
The LoRaWAN PHY version of the end device 
LoRaWAN class capabilities 
Supports class B 
Supports class C 


Device address * 
-|9 


Device address, issued by the Network Server or chosen by device manufacturer in 


case of testing range 


NwkSKey © * 
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Figure 19: Bandplan settings. 


You may notice in the code that a value is written to a file called current. 
txt. This one will store the current frame counter we are using for trans- 
mission to The Things Network.If we would not save the value, the value 
would be zero again at every restart of the node, e.g. after a battery 
change. If the counter would be reset every time the device is rebooted, 
the transmitted data would be rejected by The Things Network for 
security reasons, After every transmission, the file is updated with the 
current value used and loaded on next restart. This is not ideal and 
will shorten the flash lifetime. If we are writing every 15 minutes a new 
value, this means 96 writes a day, or 35040 writes every year, so this 
is far from perfect and needs improvement. 


To The Things Network and Back 

How to setup a LoRa Node has been discussed in previous articles, but 
| still want to share a few words about it. The former article showed The 
Things Network stack in version 2. Recently, version 3 was announced, 
and in some places, you can already transfer your applications and 
gateways into the new version 3 stack and therefore console. 


To get data transmitted, you need to add a few important parame- 
ters to the provided MicroPython files. We need to have an account 
at The Things Network to use the communities infrastructure. When 
an account has been created, or you like to create one, you can head 


over to the version 3 stack using [10]. After the login to our account, 
we need to create a new node. To create a new node, we first need to 
setup an application. As Figure 13 shows, you need to click on Create 
an application and follow the user dialog shown in Figure 14. Select 
the owner of this application, in this case your account, and fill in the 
Application-ID. A click on Create application will complete the process. 


As we have set up a new application, we can add a new node to it. 
This new node will provide the credentials we need to enter to the 
MicroPython script. In your newly created application, select Add end 
device, to start a wizard to create a new node, as seen In Figure 15. 


The wizard, shown in Figure 16, will ask to select a device. As our 
device will not be in the list, you need to choose Manually. As seen in 
Figure 17, you need to choose Activation by personalization (ABP) and 
select the LoRaWAN version for our MAC. Here you can choose MAC 
V/1.0.2. Select Start to get to the basic settings like shown in Figure 18. 


Enter the End device ID, a unique ID for your node. The field End device 
name and End device description are used for your convenience to 
later distinguish what nodes you have created. The next page, as seen 
in Figure 19, will require you to select the frequency plan. Set this 
according to your region. As the node we are doing Just does enough 
LoRaWAN to transmit data, we have no support for Class B or Class C. 
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Register end device 


From The LoRaWAN Device Repository Manually 


Basic settings © Network layer settings —— Application layer settings 

End device ID's, Name and Frequency plan, regional Application session key to 
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Skip payload encryption and decryption 
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Application session key 
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Figure 20: Application Key generation. 
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Figure 22: Basic Node-Red flow for LoRaWAN data. 
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Figure 24: Server and SSL settings. 
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Figure 21: Device information for the new node. 
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Figure 23: Server setting for the MQTT node. 
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Figure 25; User name and password settings. 


Select Application layer settings to continue. Generate an Application 
session key as shown in Figure 20 and finish with Add end device. 


A new generated device will show up, like in Figure 21. We need for 
our MicroPython script the Device address, NwkSKey and AppSkKey. 
Those will be placed in the /ora.py, where DEVADDR will hold the Device 
address, NWKEY will hold NwkSKey and APP the AppSKey. If all data is 
entered correctly, transmission will show up in The Things Network. 


Grabbing Data with Node-RED 
Installing Node-RED on a Raspberry Pi can be done by opening a 
terminal or log in via SSH and executing the following command: 


bash <(ecurl 
tent.com/node-red/linux-installers/master/deb/ 


-sL https://raw.githubusercon- 
update-nodejs-and-nodered 


To let Node-RED run as a service, you also need to enter and execute 
the following command after the node-red installation: 


sudo systemctl enable nodered.service 


The full installation guide can be found here [11]. To start the service, 
run the following command in a terminal: sudo systemctl start 
nodered.service., 


After Node-RED is set up and running, to get our transmitted data 
we need to build a flow like seen in Figure 22. Even if nodes for The 
Things Network exist, on a Raspberry Pi you need to use the generic 
MQTT connectivity. Using the nodes for The Things Network on an 
Raspberry Pi can result in errors and crashes of your dataflow. This 
may be due to some compatibility issues with the provided nodes, as 
they are running fine on X86-based hardware. 


For the MQTT connector, we are interested in the data that our node 
will transmit, called payload. Figure 22 shows the complete Node-RED 
flow to grab the data we transmit. The required configuration will start 
with the MQTT node. Here we need to supply the server, that will 
provide our data, and credentials. 


Figure 23 shows the Server and Topic that needs to be entered. A 
topic can be considered as a conversation space on a defined subject. 
In this way, only messages in which there is an interest are provided. 
We use +/devices/+/ up as the topic. This indicates that we are 
interested in all messages sent to us by the nodes registered with our 
application. As output, we expect a parsed JSON object for further 
processing. In the next step It is necessary to set the preferences for 
the servers of The Things Network. To edit a server setting, click on 
the pencil button to the right of the server. A new dialog, as shown 
in Figure 24, will show up. As we are running on the new V3 stack, 
use eul.cloud.thethings.network and port 8883. Make sure Enable 
secure (SSL/TLS) connection is checked. Under the security tab, as 
shown in Figure 25, you need to enter username and a password. As 
username use the name of the application we created before in The 
Things Network console. 


Add API key 


Name 


Rights * 
Grant all current and future rights 
® Grant individual rights 


E Select all 


Delete application 
View devices in application 
View device keys in application 
Create devices in application 
Edit device keys in application 
View application information 
Link as Application to a Network Server for traffic exchange, i.e. read uplink and write downlink 
View and edit application API keys 
Edit basic application settings 
View and edit application collaborators 
View and edit application packages and associations 
Write downlink application traffic 
Read application traffic (uplink and downlink) 


Write uplink application traffic 


Create API key 


Figure 26: Wizard for a new API key. 
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Figure 27: BASE64 decoder settings in Node-RED, 


Getting the password involves a bit more work. Head over to The 
Things Network console and enter your application. Click the API 
keys menu entry on the left and start adding an API key with Add API 
key. A new wizard like in Figure 26 will appear. Choose the required 
access rights and finish the dialog with Create API Key. The next step 
will present a new API key you can use. Be sure to store it somewhere 
safely as you cannot later access it again. This key is the password we 
need to use for Node-RED. 


If all settings are in place, the changes will be applied with Done. If 
now you deploy the settings, the MQTT node will establish a connec- 
tion and new data will be presented at the node. There is only one 
catch to the data we receive. The payload, the data our node sends, 
are encoded with BASE64. To retrieve the raw bytes transmitted, we 
need to insert a BASE64 decoder that will do the conversation. If 
configured like in Figure 27, you can access the data as array of bytes 
from following nodes. 
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Figure 28: Example dataflow in Node-RED. 


For more convenience, a demo flow like shown in Figure 28 has been 
set up and will display new arriving data accessible through a web 
browser. Figure 29 shows how the webpage looks at the end. Here 
you just need to enter your credentials. 


Simple and Beginner Friendly 

While this is not the most complex project you can do, it will allow you 
to start tinkering around the Raspberry Pi Pico and LoRaWAN. Using 
MicroPython can be, especially for beginner, a smooth transition into 
the world of embedded systems. The time required to build and run 
this project makes it suitable for (virtual) classrooms and teaching. 
But there was a PCB promised at the beginning. If you are just into 
software, you can stop reading. If you like not only using electronics 
but also building them, the next part is for you. 


A Word of Warning 

Usually, if we present schematics and PCBs in Elektor, they have been 
built and tested (at least to the extent that they will not catch fire or kill 
cute kittens). With this PCB and schematics things are different. The 
PCB and therefore the schematic is a work in progress. While it should 
work, it is not tested, so be aware that there may be some bugs left. 
Also, with this schematic, you can download all KiCad files from the 
Elektor page or the Elektor GitHub repository [12] to modify or change 
it to your own needs. If you seen some design faults or stupid design 
choices (and we do not mean something like using a Raspberry Pi 
Pico), please feel free to give us your suggestions. This is not limited 
to faults. If you missed something that you would like to have included, 
feel free to suggest your changes. As | already mentioned, this is a 
work in progress. Your feedback is welcome. 


Schematic: Part 1 

The schematics are divided into two parts, even if all components are 
on one KiCad sheet. The first part is just connectivity for the RFM95, our 
LoRa transceiver, and a DS18B20 temperature sensor to the Raspberry 
Pi Pico. For the RFM95, we need an SPI connection, consisting of 
MISO, MOSI, SCK and nCs. In addition, we need to add RESET and 
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Figure 29; Data presented as webpage. 


DIOO for minimal operation. Figure 3 shows the schematic to attach 
the RFM95 to the Raspberry Pi Pico. Also note that we have added 
two capacitors, 100 nF (C2) and 10uF (C1), next to the RFM95. The 
capacitors shall supply peak currents if the RFM95 is in transmit or 
receive mode, as recommended by the datasheet. 


Also, you can see R5, a 4.7 kQ resistor on the reset line. This one is 
normally not required, as the RFM95 offers an internal pull-up resis- 
tor. As the module has been used in a few projects, it showed that 
an external pull-up avoids undesired resets that otherwise happen 
from time to time without it. Something not used by the MicroPython 
software but may be later by C/C++ libraries are DIOO, DIO1, DIO2 
and DIO3. While DIOO is required for general operation on most LoRa 
libraries, the other DIO ones provide optional features. These features 
can be used with other librarys. 


For the DS18B20, shown in Figure 3, we actively power the VCC pin. 
One-Wire allows for passive powering by just using the data pin and 
ground (parasitic power). These non-genuine ones behave strangely 
when not actively powered via VCC. Therefore, all three pins, including 
VCC, are connected in case one of these fake sensors is accidentally 
installed. So be careful: if you accidently buy nongenuine DS18B20 
sensors, the performance might suffer, or powering it with just the 
data pin is not working at all. For One-Wire we need a 4.7 KQ pull-up 
resistor on the data line. 


The Raspberry Pi Pico is a module, so you do not have to connect 
many components. Something that is different are the V_BUS and 
V_SYS labels attached to pin 40 and 39. These will be used to attach 
a rechargeable battery to the build and will bring us to part two of 
the schematic. 


Schematic: Part 2 

The second part of the schematic, shown in Figure 30, contains the 
section for a rechargeable battery. This consists of an MCP73871- 
1CC lithium charger with power path. Thus, if we supply power to its 
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Figure 30: Battery charger and protection. 


Figure 31: First rendering 
of the routed PCB. 


input, it will pass this to its output, and not use the battery at all. If the 
external power is disconnected or insufficient, an automatic switch 
to the battery will happen. The charger is currently set up to charge 
batteries with 1000 mA. 


To protect the attached battery an XB8089D, already used in the 
GreatScott! DIY LiPo Supercharger kit [14], is included. This will prevent 
over-charge, over-discharge, over-current and reverse polarity. The 
last element is a Texas Instruments TPS25940 eFuse. This one acts 
as ideal diode, preventing a current flow back to the lithium battery 
charger. It will serve as an over-current and over-discharge protection 
element. Overvoltage und undervoltage are determined by R9, R10 
and R16. The datasheet provides the required formulas to calculate 
the desired values. We use 120 kQ for R9, 27.2 kQ for R10 and 33.2 kQ 
for R16 to get 5.37 V for over voltage lockout and 2.957 V for under- 
voltage lockout. This should be in the safe range, for the battery and 
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Figure 32: Preview on the layout done. 


for the DC/DC converter, on the Raspberry Pi Pico. We use R17 with 
47 kQ to limit the current at 1.89 A, as this is the maximum the lithium 
charger will be able to supply. Why it is a bad idea to use a polyfuse? 
Read the Elektor article [13]. Using a diode would introduce at least 
0.3 V drop across It, meaning we are converting energy into heat. 


Something not often seen in PCBs are R20, R21 and R18. Those are 
0 Q resistors that will allow you to disconnect parts of the battery 
charger. If some parts need closer investigation or don’t work at all, 
they can be separated and bypassed without breaking traces on the 
PCB. Just the removal of some SMD components would be sufficient. 


A Quick Placement on a PCB 

As the schematic is done, all parts have been placed on a PCB and 
are routed. It is not looking nice for now, but for a first try, it will server 
the purpose. Figure 31 shows the first rendering. Figure 32 gives an 
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impression how the routing looks. You can also see that the PCB Is 
designed in a way that the charging part can be completely removed 
and used for other purposes as well. If it does not work, you can also 
remove it from the PCB. It Is like two for one. 


What Is Next? 

The next steps that will follow depend on feedback from our readers, 
meaning you. If you like this project and want us to continue, add 
components or have suggestions on how to improve it, feel free to 
leave a comment or send us a message. Also, if you have suggestions 
for different parts, we are interested. You can also leave use a message 
about other potentially interesting projects. 


Final Thoughts 

Using MicroPython on the Raspberry Pi Pico and working on a 
LoRaWAN project is fairly straightforward and can be fun even for a 
beginner. But the software stability can be an issue. For more reliable 
setups, going the C/C++ way is preferred. If the MicroPython scripts 
work, it is a fast and convenient way to get started. What you measure 
and transmit is up to you, and the used code is simple enough to try 
with kids. Why only transmitting temperature information? You may 
do a LoRaWAN alert system with some PIR detectors. Or you can 
monitor if your plants need water. Let your creativity be your limit. 


While this is the first project involving the Raspberry Pi Pico, it will not 
be the last. We are preparing some more, but note that they might 
not be completely finished. Nevertheless, we hope they will inspire 
you for your own projects or give you some background that may be 
useful in the future. I€ 
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BACKGROUND 





To start, it is essential to understand that 
RISC-V is an Instruction Set Architecture, or 
ISA [1], and not a processor. This means that the 
community behind RISC-V has put together a 
description of how a processor design should 
work, should you choose to base it on their 
RISC-V ISA. And when we say ‘design, we 
really do mean creating the processor with all 
its registers, accumulators, math operations, 
memory buses, and everything else. 


The ISA documents the supported opera- 
tions, the memory addressing capabili- 
ties, how the stack functions, and what 
happens when interrupts occur, to name 
just a few items. With regard to supported 
operations, it explains how many bits are 
used to encode the Instruction and which 





bits are used to encode the source of any 
operands needed. 


The reason for the excitement is that the ISA 
is free and open. Open means that anyone 
can contribute to its development, while free 
means that it doesn’t cost a bean to use. 
However, just like Arduino board designs 
are open and free to use, that doesn't mean 
that it doesn't cost money to acquire a board, 
and the same applies to building your dream 
RISC-V-based design. 


Every processor has an ISA; almost all 
are proprietary, and some are licensable. 
Microchip produces devices that use 8-bit 


and 16-bit PIC processors and, somewhere, 
there is an ISA to describe them. These are 
proprietary cores that belong to and are 
sold by Microchip in their microcontrollers. If 
you want to build your own microcontroller, 
you'll probably take a look at Arm and MIPS. 
These proprietary cores are licensable as 
intellectual property (IP). The businesses 
behind them do all the work to convert the 
ISA into a good processor design, develop 
tools to support them, create other related 
infrastructure, and charge a fee for you to 
use them. The challenge that arises is when 
these options don't guite do what you want 
to achieve. 


Your new application may need to perform 
one task, say encryption, really fast but with 
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Figure 1: Development process for RISC-V pipeline implementation used by the BOOM project [27]. 
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Figure 2: The emulsiV simulator enables anyone to try out RISC-V in their web browser. 


minimal power draw. A potential licensable 
processor IP may execute your task in 100 
instructions. If you now wish to reduce power 
consumption, you'll need to find a silicon fabri- 
cation facility (fab) specializing in low-power. 
That may be more expensive than a ‘gener- 
al-purpose’ fab process, resulting in your 
incredible product being too expensive for 
your target market. 


However, you may also have some clever 
engineers who could optimize your code's 
execution time by creating new instruc- 
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tions for the processor but, because the ISA 
is proprietary, you're not allowed to modify 
it. So, you're stuck with a processor perfor- 
mance problem that you need to solve with a 
manufacturing approach. More on this later... 


What Does RISC-V Do 
Out-of-the-Box? 

The short answer is “not much but enough.’ 
Basically, you need to start by choosing the 
precise architecture you want. Currently, 
there are 32-bit and 64-bit ISAs defined, with 
a 128-bit ISA being worked on too. These 


base definitions are named RV32! and RV64l. 
If you select the RV32I, you'll have 49 instruc- 
tions [2] at your disposal. The ‘I, inciden- 
tally, stands for ‘Integer: Included are all the 
basic integer arithmetic and logic instruc- 
tions (ADD, SUB, AND, OR, XOR), shifts, 
compare, jump and link, and some system 
instructions [3]. If you're looking to support 
compact code, you may be interested in 
the 'C' option. This provides 16-bit instruc- 
tion encoding, something similar to the Arm 
Thumb mode. Multiplication and division (M), 
atomic (A), and floating-point (F, D, and Q) 
instructions can be added too. 


The next step is to design your processor 
core based upon the specifications of the 
chosen options in a Hardware Descrip- 
tion Language [4] (HDL), such as VHDL or 
Verilog. As this bit is not easy, this is where 
the community starts to come in. Designing 
processors take a lot of skill, so there are a 
bunch of people and businesses that provide 
you with ready-to-use designs. If you want to 
go the ‘free’ route, you should look no further 
than the PULP Platform [5], created by the 
ETH Zurich and Universita di Bologna. Their 
CV32E40P RV32IM[FIJC implementation is 
available on GitHub [6], and the instruction 
decoder is here [7] if you'd like to see how 
something like this is implemented. Another 
implementation is the BOOM project, a high 
performance and parameterizable core for 
architecture research, developed by the 
University of California, Berkeley (Figure 1). 


If you're in a hurry and need some support, 
then you'll need to put some money on the 
table and license an implementation from 
someone like SiFive [8]. They have a range 
of 32- and 64-bit designs available [9] that 
can also be customized. 


How Can I Try Out RISC-V? 
Despite RISC-V having been around for some 
time, there is not much silicon available for us 
to test. In the context of the industry, RISC-V 
is still relatively new. If you're into microcon- 
trollers, you will have seen how most of the 
industry have adopted Arm, moving away from 
their proprietary cores. That was a strategic, 
long-term investment. A move now to RISC-V 
would only save on the royalties paid to Arm 
and deliver users few benefits. They would 
also need to get their development teams 
up-to-speed on RISC-V, integrate it with all 
their other IP (analog, timers, buses, inter- 
faces, memories), update the development 
IDE, compiler, debugger, and so on. 


If you own a Seagate or Western Digital hard 
drive, you may already be ‘using’ RISC-V [10] 
[11]. But you probably actually want to run 
code on this core, not just own a product that 
uses It. The fastest way to do this is using a 
simulator such as emulsiV [12], provided by 
ESEO, that uses their RISC-V core imple- 
mentation “Virgule” (Figure 2). In addition 
to the processor, the simulator offer some 
text input/output, a bitmap output, and some 
general-purpose I/O (GPIO). Seven examples 
cover the basics, from addition and output- 
ting ASCII text, to control of the GPIOs. A 
nice touch is the “animation” option (check- 
box top middle) that shows where all the data 
comes from and goes as the code executes. 
If you like, you can try the code in Listing 1 
by copying it into a text editor, saving the 
file as program. hex, and uploading it into 
the simulator. 


If you'd like to experience RISC-V in Arduino 
format, the HiFivel Rev B is currently avail- 
able through CrowdSupply [13]. It uses the 
SiFive FE310-G002 microcontroller [14]. This is 
a bare-bones device with only digital periph- 
erals (12C, UART, SPI, PWM, GPIO) and some 
SRAM, relying on an off-chip QSPI flash for 
non-volatile storage. The board includes a 
Wi-Fi and Bluetooth module along with a 
Segger J-Link for USB debugging. 


At the other end of the performance spectrum 
is the Microchip PolarFire SoC [15] that places 
four 64-bit RISC-V cores alongside an FPGA. 
This provides a highly-configurable platform 
that can run Linux while simultaneously 
supporting hard real-time applications. 


How Do I Customize My 
RISC-V? 

Earlier, we mentioned that RISC-V's practical 
benefit was that you can tune the instruction 
set to meet Individual application needs. This 
means that if the processor implementation 
you've found does 95% of what you need, you 
can go in and add some nifty extra function- 
ality to implement the remaining 5%. Let's 
assume that your application makes heavy 
use of the ChaCha [16] stream cipher [17], 
as described in an application note [18] from 
Imperas, another RISC-V player that provides 
verification, analysis, and profiling tools. 


You've run your ChaCha implementation on 
a RISC-V core and noticed that It is eating a 
significant amount of processing time. Not 
only do you want to improve the execution 
time, but you also want to benefit from the 


Listing 1: Raw HEX code for emulsiV simulator to save and upload as 


program.hex. 


: 1000000093000002370100c083c100006388010033 
:1000100023003100938010006fFOLFFFEFOO00007d 
:1000200048656c6c6F20456c656b746F72210000c5 


:00000001FF 


Listing 2: C code to implement ChaCha stream cipher. 


unsigned int processLine(unsigned int res, unsigned int word) { 


res = qri_c(res, word); 
res = qr2_c(res, word); 
res = qr3_c(res, word); 
res = qr4_c(res, word); 
res = qri_c(res, word); 
res = qr2_c(res, word); 
res = qr3_c(res, word); 
res = qr4_c(res, word); 
return res; 


EP workspace - Debug - Imperas eGui 


File Edit Navigate Search Project Run Window Help 
ms N EO d E = 


Hr Or Ri iro 


5 © Console $] Tasks [$] Problems (@ Executables [ip iProf Function Profiling View 53 H H 
+5. Function Profile file = c:/Imperas/Examples/Models/Processor/FeatureUsage/RISCV_CustominstructionFlow/iss_cpu0.iprof 


Function Profile Sample Interval = 10 


E ity pe filter text 
& Name (location) Arcs in Samples In Arcs out From/To this Percentage (%) 
& | v Platform: iss 
am v Processor: iss/cpu0 
v Process 0 None keane E a RATAA AA ETAETA E E, : 

: > processWord 46928352 26199264 20729088 mm 50.34% =: 

: > qri_c 5182272 5182272 0 EC 10.06% 

: > qr2.c 5182272 5182272 0 E 10.06% 
qr3_c 5182272 5182272 A C 10.06% : 
qr4_c 5182272 5182272 10.06% : 

— = ae a sea 
_Mprintf_r 290 89 201 œ 0.0% 
_sfvwrite_r 99 74 25 C 0.0% 


Figure 3: The ChaCha cipher stream demanded around 55% of the processor's time using code 


compiled in standard C. (Source: Imperas Software Limited) 


drop in power that results due to the reduced 
execution time, perhaps using it to enter a 
low-power sleep mode. 


The code (Listing 2) makes extensive use 
of the XOR and rotate instructions in a step 
known as ‘quarter rounds’ for which four 
C qrX_c() functions have been written. A 
processLine() function calls these four 
functions to perform encryption. Analysis of 
execution times shows that the processor 
spends around 55% of Its time on this task, 


around 32% of which is spread across the four 
quarter-round functions (Figure 3). 


With RISC-V, we can simply implement four 
dedicated quarter-round instructions that 
execute in a single cycle instead of relying on 
the code the C compiler is forced to generate. 
This is because there is a section reserved in 
the ISA for customized instructions, Initially, 
the instructions can be added to a RISC-V 
design with the instruction’s implementation 
coded in C. This allows the new instructions 


(©lektor July & August 2021 19 





Samples in 


Arcs out 


Name (location) Arcs in Fromy/To this Percentage (%) 
+ Platform: iss 
v Processor: iss/cpu0 
v Process: 0 None 921006649 

> fread r 635365939 633628269 1737670 | o 6an 
> _ libc_init_array 0 150138664 770867985 cj 16.3% 
> processLine 135494635 135494635 0 gq.) 471% 
>  srenilr 1737670 106608 3 671587 ťi 
> readr 340125 340125 0 C] 8.04% 


Figure 4: By using dedicated, newly developed instructions, the ChaCha cipher stream processor load 
drops to less than 15%. (Source: Imperas Software Limited) 


to be simulated to test their functionality 
and checks if a performance improvement 
is attainable. In this case, with dedicated 
quarter-round instructions available on the 
customized RISC-V core, the processLine() 
function requires less than 15% of the avail- 
able processor performance (Figure 4), If 
this is considered a success, the develop- 
ment team can then develop the hardware 
implementation of the instructions in Verilog. 


Using the new instructions Is, alas, not as 
easy as recompiling the C code (Listing 3). 


Py RISC-\’’ 


Modifying a RISC-V compiler to utilize the 
new instructions is an enormous effort. 
Instead, the hex-encoded Instructions are 
called using inline assembler in the same 
manner as hand-optimized code. 


How Can I Contribute to 
RISC-V? 

If you're interested in helping the ongoing 
development of RISC-V, you're in luck! 
RISC-V International [19] is the organiza- 
tion trusted with developing and promoting 
all things RISC-V (Figure 5), Individuals can 


Figure 5: Official logo of RISC-V International who promote and support development of the the ISA. 


Listing 3: Using the new RISC-V instructions. 


join as Community Members [20] or, if you 
want to build a career on It, there are plenty 
of businesses and universities [21] who are 
actively involved. 


If you're expecting a wide array of RISC-V 
microcontrollers to hit the market, you may be 
disappointed. GigaDevice offers some devices 
[22], and there is another from a Russian 
supplier targeting the smart metering market 
[23]. However, Arm is too entrenched with 
the big players, and start-ups will struggle to 
compete in this saturated market, even with 
the financial benefit of a processor for which 
royalties do not need to be paid. 


Instead, we are more likely to see RISC-V 
being used in specialized applications where 
the ability to customize the core brings huge 
benefits, such as ultra-low power [24]. With 
issues around licensing technology to China, 
RISC-V Is proving a popular alternative to 
acquiring IP from the United States. Alibaba 
has announced a 16-core, 2 GHz, 64-bit 
RISC-V built in a 12 nm process [25] and 
indicates that the core is being viewed for use 
in server infrastructure. Finally, the European 
Processor Initiative [26] has been looking at 


Using the new RISC-V instructions requires inline assembler. The instructions are coded as hexadecimal as the assembler doesn't 


know the names of these new instructions. 


unsigned int processLine(unsigned int res, unsigned int word) { 


asm __volatile__("mv x10, %0" eresi, 

asm __volatile__("mv x11, %0" lean (WOK is 

asm __volatile__(".word 0x00B5050B\n" "x10"); // equivalent to qri_c() 
asm __volatile__(".word 0x00B5150B\n" "x10"); // equivalent to qr2_c() 
asm __volatile__(".word 0x00B5250B\n" "x10");.// equivalent to qgr3_c() 
asm __volatile__(".word 0x00B5350B\n" "x10"); // equivalent to- qr4_c() 
asm __volatile__(".word 0x00B5050B\n" uxt") = // “equivalent. to- gri c() 
asm __volatile__(".word 0x00B5150B\n" "x10"); // -equava lent, to- gr2_c() 
asm __volatile__(".word 0x00B5250B\n" UXO") = // “equivalent to-gr3-c() 
asm __volatile__(".word 0x00B5350B\n" "x10"); // equivalent to qr4_c() 


return res; 
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heterogeneous architectures that could see 
Arm and RISC-V (or other cores) side-by-side. 
The aim here is to get the best of both worlds 
by using the best processor for each comput- 
ing challenge in multicore designs. 


RISC-V is not the first free and open attempt 
at processor IP, but it has been the most 
successful to date. Given its heritage, flexi- 
bility, open approach, interest from academia, 
and extensive industry support, it is a technol- 
ogy that will accompany a generation or more 
of engineers for their entire careers. a 
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Questions or Comments? 

Do you have technical questions or comments regarding this article? 

Then contact the author directly via stuart.cording@elektor.com or the editor via 
editor@elektor.com. 
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Sixty years of Elektor magazine! Since 1961, we have reported 


on the latest technologies, devices, boards, and components 
- with the typical mix of theory and practice. For decades 
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there was something special in the summer: our ‘Summer 

Circuits’ was a collection of many mini-projects, often with 
more than 100 in that single issue. Almost all of them were 
easy to build and not overly complicated electronically, but 


still very, very useful... 
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Figure 1: Hand PCB layout: The “100 W power amp (40411)” PCB (in the German edition). 
www.elektormagazine.de/magazine/elektor-197011/54723 


| have been a keen Elektor reader from the 
very beginning. As soon as | learned which 
end of the soldering iron to hold in the 1970s, | 
became hooked. | can't remember how many 
of the projects have been recreated in my 
home lab, but I've always liked the collec- 
tion of mini “circuit ideas” that have been an 
annual feature of the magazine. They are a 
unique treasure trove of ideas. Many electron- 
ics engineers — even those in industry — have 
been inspired by these, often unconventional, 
solutions. Motto: There is always something 
interesting in Elektor. 


Amplifiers... 

Elektor and Edwin — for veteran audio 
electronics enthusiasts, these two names 
simply go together. An amplifier design was 
included tn the first German-language edition 
of this magazine. Its “special feature” was the 
absence of a (drifting) quiescent current. As 
we all know, you can never have enough 
amplifier designs. The first German-language 
edition containing the mini-circuits supple- 
ments in 1970 featured a total of 8 amplifier 
designs out of a total of 104 circuits [1]. At that 
time, circuit board layouts were all done by 
hand at Elektor. Figure 1 shows an example of 
this with the “100 W power amplifier (40411) 
Back in those days, 2 x 6 W was a typical 
rating for a Hi-Fi setup, so 100 W was a real 
sledgehammer. The number in brackets refers 
to the NPN power transistor type used in the 
output stage (packaged in the most modern 
TO3 outline). As you might expect, the design 
was quite advanced and used a 709 opamp 
(the predecessor to the 741) in the front end. 
The English-language version of the magazine 
did not appear until December 1974. 


In 1975, the “Summer Circuits” were included 
as a supplement to the July/August double 


edition [2]. Although the term “amplifier” 
appears a good 18 times in the list of circuits, 
| was particularly interested by project #16, 
the “Bat Detector” (Figure 2). Here, the ultra- 
sound chatter made by bats is “mixed down” 
to audible frequencies with the help of a signal 
from an oscillator. As was typical at the time, 
the design used lots of discrete transistors 
(the magazine's English language version did 
not include the circuit). 


By 1980 | was part of the editorial team. As 
the youngest Elektor employee, | was amazed 
by the psychedelic front cover of the 1980 
Summer Circuits edition [3] (Figure 3). As 
usual, this edition contained a good sprinkling 
of amplifier designs. In those days, we were 
concerned about the merits of circuit details 
such as cascode transistor configurations. But 
it was another circuit idea in this edition that 
amazed me. A version of another perennial 
favorite, a NiCd battery charger (there were 
few alternative rechargeable cell technolo- 
gies in those days). The special thing about 
this design (Figure 4) was that it didn't use 








a mains transformer. It was “mains fed” i.e. 
“capacitor-coupled without a transformer’ Bob 
van der Horst, the chief editor at the time, 
insisted on the no-transformer design. The 
skull and crossbones symbol on the schematic 
lets you know that this circuit could be poten- 
tially lethal if you weren't careful! 


Touching on the 80s 

The idea of home automation didn't just arrive 
with the Internet. In the 1985 Summer Circuit 
issue, you can find a Twin Dimmer switch with 
“touch” controls. Thanks to the electronics 
using two ICs anda round PCB (Figure 5), this 
lighting control fitted into a standard junction 
box. At this time, printed circuit boards were 
designed with adhesive symbols at Elektor. 


The topic of model making wasn't neglected 
in the summer circuits either. In March 1989, 
a sound generator circuit was included that 
mimicked the noise produced by a marine 
diesel engine. The circuit in Figure 6 shows 
that all we need Is a standard opamp, two 
transistors, an LDR, and a light bulb to make 
the characteristic tugboat pounding noise of 
a marine diesel engine. The sound was even 
speed-dependent. 


Magical Mystery Tours 

A particularly popular theme is the featured 
circuits that will never work or are not at all 
effective. Despite good scientific evidence to 
the contrary, many users of some of these 
designs swear they are useful. Cures to 
prevent furring-up of the inside of kettles 
and water heaters are still widely on sale. An 





Figure 2: Circuit for listening to bat chat (in the German edition). 
www.elektormagazine.de/magazine/elektor-197507/55831 
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Figure 4: Transformer-less NiCd charger. The fully insulated 


housing is shown below. 
www.elektormagazine.com/magazine/ 
elektor-197999/44465 





Figure 5: Twin Dimmer PCB. 
www.elektormagazine.com/magazine/elektor-198499/46834 


electronic water softener appeared in the 1994 
Summer Circuits issue (Figure 7). This unit 
applies a 400 Vpp, 700 Hz alternating field to 
the incoming flow of water. The article claimed 
it was a Substitute for water softeners that use 
a scientifically proven (and many times more 
expensive) mineral-extraction technique. It 
was not the first descaler of its kind to feature 
in Elektor, and there must still be many of 
these devices strapped to water pipes all 
around the world. You can even buy similar 
designs off-the-shelf in hardware stores. Some 
of them are said to be effective despite the 
shielding offered by the earthed copper pipes. 


PCs and more 


Turn of the millennium: From the series 
“Circuits with almost no components” 
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Figure 3: Summer Circuits 1980... Groovy! 
www.elektormagazine.com/magazine/ 
elektor-197999 














Figure 6: A few components simulate the sound of a marine diesel. 


comes the “PC Battery Charger” contribu- 
tion (Figure 8) by the longstanding Elektor 
contributor Burkhard Kainka. By now, every 
electronics technician had a PC sitting on their 
desk, and many wondered how else it could 
be usefully employed. Most were fitted with 
at least one serial port before the USB port 
replaced them all. This idea adds together 
current from the data signals via a three-in- 
put OR gate constructed from diodes to trickle 
charge three NiCd batteries... 


Home and garden projects were not forgot- 
ten either. The “Slug Repellant” described in 
Summer Circuits 2006 (#63) also provided the 
background of how the circuit was developed, 
tested, and refined to help protect the author's 
soft fruits from marauding slugs and snails 


www.elektormagazine.com/magazine/elektor-198903/47528 


(Figure 9), The final design uses digital ICs 
and a power amplifier output stage to energize 
an electric fence that repels these unwanted 
gastropods. 


On top of this are the many RF circuits and 
tools for amateur radio operators and RF 
engineers. The Elektor DSP radio, featured 
in 2010, can be seen in its prototype form in 
Figure 10. This was a popular and cutting- 
edge world receiver featuring a USB inter- 
face that even got by without any (dreaded) 
adjustment. 


Just for Fun... 

It's something of a tradition for Elektor to 
occasionally include a less-than-serious 
circuit with no practical use that either cannot 









Figure 7: Water Softener. 
www.elektormagazine.com/magazine/ 
elektor-199407/33139 





Figure 9: Slug Repellant. 


www.elektormagazine.com/magazine/elektor-200607/18323 


work or does not work as described. Even 
worse, the circuit may have been designed to 
create havoc or prank a colleague deliberately. 
One that comes to mind Is the “Electronic 
Mosquito” [4] from the 1990 Summer Circuits. 
If someone had hidden that device in my 
bedroom, | don't think | would have seen the 
funny side... That really was a mean design! 
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ae Addendum 
& The last regular semiconductor issue 


004036 - 11 with over 100 mini-circuits appeared in 
Aimee: ACE BRe Cuma: 2012. That may be a shame, but in the 
www.elektormagazine.com/magazine/ six decades since Elektor was founded, 
elektor-200007/16844 electronics have become more complex 
and industrial. A circuit with a handful 
of components is no longer enough to 
justify a published article. Over the years, 
Free Article Downloads! Elektor has covered applications inclu- 
ding charging, power supplies, dimming, 
LEDs, and sending and receiving informa- 
tion. In many projects, the hardware can 
now be replaced by a general-purpose 
microcontroller with its actions defined in 
software. Inevitably, more precious space 
is taken up by descriptions of IDE instal- 
lation, programming language tips and 
tricks, and more. That doesn't mean we 
have abandoned our love of small circuits 
— on the contrary — after all, beginners, 
in particular, can learn a lot here! Why not 
take a look at our new series featuring more 
novel circuits to whet your appetite on our 
website: www.elektormagazine.com/tags/ 
circuit-shorts. 
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Figure 10: The Elektor DSP radio, 
https://www.elektormagazine.com/magazine/elektor-201007/19338 
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3] Elektor issue 7-8/1980: www.elektormagazine.com/magazine/elektor-197999 
4] Electronic Mosquito: www.elektormagazine.com/magazine/elektor-199007/32191 
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Positive and Negative Voltages 


Out of 5 V from USB 


By Fons Janssen (The Netherlands) 


Breadboard power supplies are useful when 
no desktop lab power supply is available. 
Most of the modules on the market are 
limited to positive output voltages, lower 
than the input voltage. The project we 
present here is different. With the help 

of two integrated circuits from Maxim 
Integrated, a5-V micro-USB adapter at the 
input provides up to four adjustable output 
voltages, three positive ranging from 0.6 V to 
20 V and one negative from -1.8 V to -11 V. 


A breadboard is not only a handy tool for experienced electronics 
engineers who want to test something quickly, but also for beginners, 
makers or students taking their first steps in the world of electronics. 
No soldering is required to build a circuit and changing components 
or wiring is very easy. Because every circuit needs to be powered in 
one way or another, we have designed a power supply that can easily 
be used on a breadboard. 


Although a benchtop power supply is the preferred power source 
when experimenting with electronics or prototyping, this type of lab 
equipment is not always available. On the other hand, 5 V power 
adapters with micro-USB plugs are everywhere. We all probably have 
more of these lying around than needed for powering or charging 
the devices we own, like mobile phones and other electronic equip- 
ment and gadgets. Most of these adapters are short-circuit proof, 
and combined with the project we present here, you have the perfect, 
affordable solution for powering circuits on breadboards. Power is 
limited, but as we all should know: breadboards are not designed for, 
and definitely not suitable for, high-power circuits. 
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There are many breadboard power supply PCBs on the market, but 
unlike this one, most are limited to output voltages lower than the 
input, and negative or symmetrical outputs are even more rare, if not 
non-existent. The circuit presented here is a novelty in that respect. 
It is designed so that you can quickly create a negative or symmetric 
(e.g, +9 V/-9 V) power supply from your standard 5 V power adapter 
for, for example, an op-amp circuit. The positive output voltage can 
even be up to 20 V! But you can also make a low 3.3 V for your micro- 
controller. It is all adjustable. The breadboard power supply board 
contains only two integrated circuits and is designed to provide four 
output voltages: one negative and three positive. 


The Schematic 

Figure 1 shows the schematic of the breadboard power supply. The 
heart of the circuit is the Maxim MAX8614B [1]. It is equipped with a 
boost converter that can generate a voltage (Vgst) higher than the 
input voltage and an inverting buck-boost converter that can gener- 
ate a negative voltage (Vin). 


Potentiometer P1 is in the feedback of the positive boost converter, 
allowing the output voltage to be adjusted between: 


120k f aa 620k ? aa 
(= + 1) x 1.01V ~ +5V and (== Ņ 1) x 1.01V ~ +20V 


The inverting buck-boost converter also has a potentiometer (P2) in its 
feedback circuit which allows its output voltage to be adjusted between: 


<2 SES GY and CHAS a TV 
27k 27K 


The maximum output power that the converters can deliver is about 
2 W for the boost converter and 1 W for the buck-boost converter. This 
means that for higher output voltages, the maximum output current will 
be lower. Remember that also the ripple voltage increases with higher 
loads. It is therefore recommended to place an electrolytic capacitor of 
a few hundred micro-Farads on the power rails of the breadboard. Pay 
attention to the polarity of this capacitor and check Its voltage rating! 


The second integrated circuit in this schematic is the MAX38903 (also 
from Maxim, see [2]), which is a linear voltage regulator (LDO) that 
can be adjusted with P3 to an output voltage between: 













micro USB ATB+ 





Figure 1: Schematic diagram of breadboard power supply. 


D1, D2 = PMEG4010BEA 


C10 Es 
ie 100n 500k y 
MAX38903B A 
R7 


(= +1) x 0.6v = +0.6v and (=+ 1) x 0.6v ~ +5V 


With an LDO, the output voltage cannot be higher than the input 
voltage. The maximum output voltage will depend on the voltage of 
the power adapter (5 V here), the losses in the cable/connectors and 
the drop-out voltage of the MAX38903. In practice this maximum is 
about 4.5 V. The maximum current this LDO can handle is 1 A. Most 
adapters can deliver this, but at lower output voltages the power dissi- 
pation in the chip will increase significantly: 


Paiss = (5V = Vout) x lout 


This dissipation should not exceed 2 W, so 1A can only be supplied at 
output voltages higher than 3 V. Fortunately, the MAX38903 is equipped 
with various protection circuits, so we do not have to worry that our 
power supply goes up in smoke because the power limits are exceeded. 
The circuit on the breadboard itself is of course at your own risk. 


Assembly 
The Gerber files for ordering the PCB are shown in Figure 2. The 
DesignSpark design files are available for download at [3]. 
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Figure 2: PCB layout, the design and Gerber 
files can be downloaded. 
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Figure 3: The power supply on an MB102 breadboard with extra 
electrolytic capacitors. 


The PCB has been kept as compact as possible, best thing to do is to 
place the SMD components first, starting with the ICs. Soldering these 
tiny parts in their TDFN-packages is quite a challenge and building 
is certainly not recommended for inexperienced makers. There will 
be soldering wizards who can solder the pads on the sides of the 
packages with a small iron, but soldering the exposed pads underneath 
requires a hot-air station or reflow oven. Solder paste is preferred, even 
though the designer managed to build his prototypes by tinning the 
pads with normal solder wire, applying extra flux and using a hot-air 
station for reflowing. A magnifying glass, digital microscope or even 
a stereo-microscope will be a great help to inspect the solder joints 
before you proceed with the other components. Soldering the micro- 
USB connector may seem less challenging but will be a good one 
to come in third. Next, the surrounding coils, diodes, resistors, and 
capacitors can be mounted and finally the through-hole components, 
such as the switch, LEDs and pin headers, that can easily be handled 
using a normal soldering iron. For JP1, two outer pins of one of both 
rows of a 3 x 2 pin header are cut off, making it a triangular-shaped, 
4-pin jumper configuration. 


Usage 

The power supply can be plugged into the breadboard as shown in 
Figure 3. Connectors J1 and J2 are plugged into the horizontal power 
rails of the breadboard. The top rail is then connected to V+, the bottom 
one to V- and the two inner power rails to GND (all power supplies of 
this board share a common GND). 


The PCB can be supported on the left side on the lab table using two 


12-mm M3 spacers or bolts, two mounting holes are available for this 
purpose. This improves the mechanical stability of the connection 


a= WEBLINKS 








Figure 4: Positive rail jumpered to Vgsp the jumper wires connect 
Vi po and +5 V to the breadboard. 


between power supply and breadboard and prevents the board from 
tipping over when adjusting the output voltages. 


Switch S1 can be used to switch the entire power supply on and 
off. When the power supply is switched on, LED1 lights up green as 
Power-On indicator. 


Since there are three positive supply voltages on the PCB, the user 
must select which one is connected to the upper supply rail of the 
breadboard (V+); this can be done with jumper JP1. Place the jumper 
in position 1-2 for the low adjustable voltage (V, po), in position 1-3 
for the high adjustable voltage (Vast) and in position 1-4 for the fixed 
+5 V. The jumper positions are also marked in the silk screen on the 
PCB. The two remaining voltages can still be connected to the circuit 
on the breadboard using male-to-female jumper wires, as shown In 
Figure 4. In this picture, the Vgsr Is Jumpered to the positive rail, while 
the orange and blue jumper wires connect the +5 V and V, po to the 
breadboard. The negative output voltage Vny Is directly connected 
to the lower supply rail (V-). 


The voltages are adjusted by means of multi-turn potentiometers P1 
to P3. The silk screen on the PCB shows which trimmer is associated 
with which output. There are test points for a multimeter to measure 
V+ (TP3) and V- (TP1) during adjustment, TP2 and TP4 are connected 
to GND. 


There are two red LEDs to indicate an overload or short circuit of one of 
the power supplies: LED2 (also marked with FLT1 on the PCB) for Vgst 
and/or Viny and LED3 (FLT2) for Vipo The boost converter and LDO 
limit the output current at overload and the outputs will be switched 





[1] Maxim Integrated, “MAX8614A/MAX8614B: Dual-Output (+ and -) DC-DC Converters for CCD,’ 12/2019: 


https://datasheets.maximintegrated.com/en/ds/MAX8614.pdf 


[2] Maxim Integrated, “MAX38903A/MAX38903B/MAX38903C/MAX38903,' 4/2020: 
https://datasheets.maximintegrated.com/en/ds/MAX38903A-MAX38903D.pdf 
[3] This project’s downloads: https://elektormagazine.com/210068-01 
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off if on-chip thermal limits are exceeded. In both cases the LEDs will 
be lit. If the buck-boost converter is overloaded, both outputs of IC1 
are switched off and LED2 lights. Power-cycling the supply with S1 
resets this fault condition, the output voltages will be restored and the 
red LED will go off again, provided there is no short-circuit, of course. 
However, there is no overload indication for the fixed +5 V. In this case, 
we trust that the power supply is short-circuit proof. 


Although this project is designed and intended to be used on bread- 
boards, it can of course also be useful as a simple, low-power supply 
for other applications by connecting wires between the output pins 
and other electronic (prototyping) circuits. At last, you can put that 
superfluous 5 V micro-USB adapter to good use on the lab table! 


This project can also be found and followed on Elektor Labs website: 
www.elektormagazine.com/labs/breadboard-power-supply 
210068-01 


Questions or Comments? 

Do you have technical questions or comments about his article? 
Email the editor at luc.lemmens@elektor.com or contact Elektor 
at editor@elektor.com. 


Contributors 

Design and Text: Fons Janssen 

Editor: Luc Lemmens 

Illustrations: Patrick Wielders, Fons Janssen, Luc Lemmens 
Layout: Harmen Heida 
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COMPONENT LIST 


Resistors (size 0603, unless otherwise stated) 

R= 39k 

R2= 27k 

R3 = 120k 

R4 = 33k 

R5,R6,R8 = 4k7 

R= 06k 

P1,P3 = 500 k multi-turn trimmer (Vishay style 24 W) 
P2 = 200 k multi-turn trimmer (Vishay style 24 W) 


Inductors 
L1,L2 = 10 yp, 1 A (Fastron 242408FPS) 


Capacitors 

C1,C2 = 10 m 16 V X5R size 0805 
C3,C4 = 4u7, 50 V X7R size 1206 
C5,C6,C8 = 1 u, 16 V X7R size 0603 


Related Products 





> Breadboard (830 Tie Points): 
www.elektor.com/breadboard-830-tie-points 


> Andonstar AD407 HDMI Digital Microscope with 7” 
LCD Screen: 
www.elektor.com/andonstar-ad407-hdmi-digital- 
microscope-with-7-Icd-screen 


Specifications 

> Fits exactly on MB102 breadboards. 

> One adjustable negative voltage from -1.8 V to -11 V (Vinjyy). 

> One adjustable positive voltage from +0.6 V to +5 V (VL po). 

> One adjustable positive voltage between +5 V and +20 V (Vgcz7). 

> One fixed positive voltage of +5 V (from the power supply). 

> Can be powered with a standard 5 V phone charger with micro- 
USB connector. 

> Outputs (except for +5 V) protected against overload and short 
circuits. 





C7 = 220 n, 16 V X7R size 0603 

C9 = 4u7, 25 V X5R size 0805 

C10 = 100 n, 16 V X7R size 0603 
C11,C12 = 100 n, 50 V X7R size 0805 


Semiconductors 

D1,D2 = Schottky diode 40 V/1 A PMEG4010, SOD-323 

LED1 = low-current LED 3 mm, green 

LED2,LED3 = low-current LED 3 mm, red 

IC1 = Dual-Output (+ and -) DC-DC Converter MAX8614BETD+ 
IC2 = 1.7 -5.5 VIN, 1A adjustable LDO MAX38903BATB+ 


Miscellaneous 

J1,J2 = pin header 2 x 2 pins (pitch 100 mil) 

JP1 = pin header 2 x 3 pins (pitch 100 mil, see text) 

K1 = micro-USB connector, Amtek MIUSB-F5M-AGB-U 
S1 = slide switch SDPT, NKK Switches CS12ANW03 
jumper cap for JP1 
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the Raspberry Pi Pico 
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By Dogan Ibrahim (United Kingdom) 


* This installment of Elektor Books presents 

NSS Ay roughly half a chapter excerpted from Dogan 

V Ibrahim’s book Raspberry Pi Pico Essentials 

published by Elektor in March 2021 and nowa 

bestseller. At that time, it was the first third-party 

book with tried and tested, real-life dealings with the 

RP2040 microcontroller onboard the Raspberry Pi Pico 

module, complete with software to go. Is ‘the Pico’ as 

accessible as it’s claimed to be, and does it live up to its 
expectations of being a ‘drop-in’ controller board? Let's 


find out in this article. 


Editor's Note: This article is an excerpt from the book Raspberry Pi Pico Essentials, refor- 
matted and lightly edited to match Elektor Magazine standards and page layout. Being 
an extract from a larger publication, some terms in this article may refer to discussions 
elsewhere in the original book publication. The author and editor have done their best 
to avoid such instances though, and are happy to help with queries. Contact details are 
in the Questions or Comments? box. 


sor board. This is a tiny board (see Figure 1), 
measuring only 2.7 cm x 1.2 cm, and based 
on the ESP8266 processor chip, and costing 
around USs 4 or € 4-5. The ESP-o1 has the 
following motivating features: 


> Operating voltage: +3.3 V 

> Interface: using simple AT commands 
over serial port/UART 

> Integrated TCP/IP protocol stack 

> 802.11 b/g/n 

> No external components required 


In this article (originally about half of | commands include: 
book chapter 10, Ed.) we shall be develop- 

ing a project using a Wi-Fi link to establish LON 
communication between the Raspberry Pi LOFF 


Pico and a smartphone. 


Turn LED ON 
Turn LED OFF 


Aim: The aim of this project is to showcase The ESP-01 communicates with the host 


Controlling an LED from a 
Smartphone Using Wi-Fi 
Description: In this project, we will be 
sending commands over the Wi-Fi link 
from a mobile phone to control an LED 
(the LED can be replaced with a relay, 
for example, to control a piece of equip- 
ment) connected to the Raspberry Pi 
Pico. Commands must be terminated 
with a Return (CR/LF or ‘newline’). Valid 
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the use of the Wi-Fi connectivity on the 
Raspberry Pi Pico. 


Pico Wi-Fi Connectivity: The Raspberry 
Pi Pico has no built-in Wi-Fi module and 
as such it cannot be connected to a Wi-Fi 
network without interfacing it to an exter- 
nal Wi-Fi module. Perhaps the easiest and 
the cheapest way of providing Wi-Fi capabil- 
ity to the Pico is by using an ESP-01 proces- 


processor through its TX and RX serial port 
pin. It is an 8-pin board with pin names as 
follows: 


VCC: — +3.3 V power supply pin 
GND: Power supply ground 
GPIOo: I/O pin. This pin must be 


connected to +3.3 V for normal 
operation, and to GND for upload- 
ing firmware to the chip 


GPIO2: General purpose I/O pin 

Rol, Reset pin. Must be connected to 
+3.3 V for normal operation 

CH_PD: Enable pin. Must be connected to 
+3.3 V for normal operation 

TX: Serial output pin 

RX: Serial input pin 


The ESP-o1's pins are not standard bread- 
board-compatible, so an adaptor is required 
if the board is to be attached to a bread- 
board (see Figure 2). 


Block Diagram: Figure 3 shows the project 
block diagram. 


Circuit Diagram: Figure 4 shows the 
circuit diagram of the project. The 
Raspberry Pi Pico’s UART o TX and RX pins 
are used to communicate with the ESP-01. 


Program Listing: Listing 1 shows the 
program listing (program: Picowifi). It is 
included in the cumulative programs file 
found under Downloads on the Elektor 
web page for the book [1]. Inside the setup 
routine serial communication speed is 
set to 115200 which is the default Baud 
rate for ESP-o1, and the LED is configured 


as an output and turned OFF. Function 
ConnectToWiF i is called to connect to the 
local Wi-Fi router. AT-style commands are 
used to configure the ESP-01 to connect to 
the Wi-Fi router. 


The remainder of the program runs in an 
endless loop formed using a while state- 
ment. Inside this loop, data is received from 
the smart mobile phone, and the LED is 
controlled accordingly. Commands LON 
and LOFF turn the LED ON and OFF respec- 
tively. Data packets are received from the 
smartphone using the readline function. 
Function find looks for a substring in a 
string and returns a non-zero value if the 
substring is found. The find function is 
used because the data received from the 
mobile device is in the following format: 
+IDO,n: data (e.g. +ID@,3:LON) where o is 
the link ID and nis the number of charac- 
ters received. Using the function find we 
can easily search for the strings LON or LOFF 
in the received data packet. 


Function ConnectTowiFi sends the follow- 
ing commands to the ESP-01 to connect to 
the Wi-Fi network: 





Figure 1: ESP-01 processor board. 





Mobile Phone 








Figure 3: Block diagram of the project. 


Raspberry Pi Pico 


GPO (TX) RX 


GP1 (RX) TA 


AT+RST reset ESP-01 
AT+CWMODE set ESP-01 mode (here it is 
set to Station mode) 

set Wi-Fi SSID name and 

password 

set connection mode 

(here it is set to multiple 

connections) 

returns the IP address (not 

used here) 

AT+CIPSTART set TCP or UDP connec- 
tion mode, destination IP 
address, and port number 
(here, UDP is used with the 
port number set to 5000. 
The destination IP address 
is set to “O.0.0.0” so that 
any device can send data 
as long as port 5000 is used 
(You can change this to the 
IP address of your smart- 
phone to receive data only 
from your phone). 


AT+CWJAP 


AT+CPIMUX 


AT+CIFSR 


Notice that small delays are used after each 
command. Command AT+CWJAP requires 
a longer delay. The program can easily 
be modified such that the delays can be 
removed and the responses from the ESP-01 






Figure 2: ESP-01 
breadboard adapter. 


CH PD 
GPICO 


ESP-01 






Raspberry Pi 


Pico 


Figure 4: Circuit diagram of the project. 
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Listing 1: Python program to control an ESP-Ol as Wi-fi-module 


ETS se ge cog eg ho enone OE regi ere ge eer E E cee Oy yes ee ec 
# USING WiFi 

H ==========- 

i 

# In this project a ESP-01 chip is connected to the Raspberry 
# Pi Pico. This chip is used to connect the Pico to the Wi-Fi 
# 

# Author: Dogan Ibrahim 

# File : Picowifi.py 

# Date : February 2021 


from machine import Pin, UART 
import utime 
uart = UART(O, baudrate=115200,rx=Pin(1) ,tx=Pin(0) ) 


LED = Pin(16, Pin.OUT) 
LED.value(0) 


# 
# Send AT commands to ESP-01 to connect to local WI-Fi 
# 
def ConnectToWiFi(): 
uart.write("AT+RST\r\n") 
utime.sleep(5) 


uart.write("AT+CWMODE=1\r\n") 
utime.sleep(1) 


uart.write(’’ ’AT+CWJAP="BTHomeSpot-XNH" ,"49345xyzpq"\r\n?’?’?) 
utime.sleep(5) 


uart.write("AT+CPIMUX=0\r\n") 
utime.sleep(3) 


uart.-write( 7 ATICIPSTART="UDP™ "0.0.0.0". 50005000, 2\r\n 7) 
utime.sleep(3) 


ConnectToWiFi() 


# 
# Main program loop 
# 
while True: 
buf = uart.readline() # Read data 
dat = buf.decode(’UTF-8’ ) # Decode 
he = dat: and (EON) # Includes LON? 
Jr mM s Or 
LED.value(1) # LED ON 
n = oat. rine LORRY) # Includes OFF? 
ir n > OF 
LED.value(0) # LED OFF 
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can be checked. This way, as soon as the 
correct response is received, the program 
can continue. You may have to hardware-re- 
set the ESP-o1 by powering it down and up 
again before you run the program. 


Testing the Program 

The program can easily be tested using the 
PacketSender program (see Figure 5) on the 
PC or using a smartphone after installing 
a UDP app. 


You should install a UDP Server app on your 
Android mobile phone before starting the 
test with the smartphone. There are many 
freely available UDP apps in the Play Store. 
The one installed and used in this project 
is called the UDP/TCP Widget by K.J.M, as 
shown in Figure 6. 


The steps to test the program are as follows. 


> Construct the circuit. 

> Download the program to your 
Raspberry Pi Pico. 

> Start the UDP/TCP Widget app on your 
mobile phone. 

> Click the gear symbol and set the Proto- 
col to UDP, IP address to the IP address 
of your Raspberry Pi Pico (192.168.1.160 
in the author's Pico), and set the Port to 
5000 as shown in Figure 7. 

> Click the MESSAGE menu item and 
select Text (UTF-8) as the Format, and 
enter command LON to turn ON the 
LED. Select LF\n as the Terminator and 
click the OK symbol (check symbol), as 
shown in Figure 8. 

> Now, click the SEND button (Figure 9) 
to send the command to the Raspberry 
Pi Pico. You should see the message 
Packet Sent displayed at the top of your 
Android screen temporarily. 


Notice that the IP address of the ESP-o1 can 
be obtained by scanning all the devices on 
the local Wi-Fi router. For example, the 
Android app called Who Uses My WiFi 
- Network Scanner by Phuongpn can be 
used to see the IP addresses of all the 
devices connected to your router. The 
ESP-01 is listed as shown in Figure 10 (IP: 
192.168.1.160), with the name Espressif. K€ 

210198-01 




















& Packet Sender = o x 
File Tools Help 
Name |Packet Name 
salon eee 
HEX [4c 4f 46 46 Od 0a ©| Load File 
Address |192.168.1.160 © | Port [5000 © | Resend Delay [0.0/blani i UDP + Send Save 

















Search Saved Packets.. Delete Saved Packet [_] Persistent TCP 
Send Name Resend (sec) To Address ToPort Method ASCII Hex 
Clear Log Log Traffic  Savelog | Save Traffic Packet Copy to Clipboard 
Time From IP From Port To IP To Port Method Error ASCI Hex 
1 we 9:17:53.743 am You 5000 192.168.1.160 5000 UDP LON\r\n 4c 4f 4e Od 0a 
2 we 9:10:27.409 am You 5000 192.168.1.160 5000 UDP LOFF\r\n 4c 4f 46 46 0d Oa 
< > 
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€ New Packet € New Packet 
CONNECTION MESSAGE RESPONSE WIDGET $ CONNECTION MESSAGE RESPONSE WIDGET d 
Protocol Format 
@vuop Orcp @ Text (UTF-8) © Hex 
IP Address Message 
Q | 192.168.1160 ‘any 
Port V 
(5000 
Needs WiFi & Terminators 
Figure 7: Configuring the app. CR\r Ga = NULL NO 











Figure 8: Command to turn ON the LED. 


Related Products 


Raspberry Pi Pico 
Essentials 


> Book: “Raspberry Pi Pico Essentials” 
www.elektor.com/raspberry-pi-pico-essentials 


> E-book: “Raspberry Pi Pico Essentials” 
www.elektor.com/raspberry-pi-pico-essentials-e-book 


> Raspberry Pi Pico Microcontroller Board 
www.elektor.com/raspberry-pi-pico-microcontroller-board 
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Figure 6: UDP/TCP Widget apps for Android. 


Uninstall 


Figure 5: Using the 
PacketSender to test the 


program. 











UDP/TCP Widget 

New Packet 

192.168.1.160:5000 ©} (> senn | 

srik Figure 9: Click 

SEND to transmit 

New Packet 

192.168.1.160:5000 O >> SEND the command. 

SES 192.168.1.150 


=, 


Espressif 
: ESP_14C051.home 


192.168.1.160 


Figure 10: Finding the IP address of the ESP-01, 


[1] Example program files: www.elektor.com/raspberry-pi-pico-essentials 


Questions or Comments? 

Do you have any technical questions 
or comments related to this 

article? Then email the author at 
d.ibrahim@btinternet.com, or Elektor at 
editor@elektor.com. 


Contributors 

Text: Dogan Ibrahim 

Editor: Jan Buiting 

Layout: Giel Dols, Harmen Heida 
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agnetic 
Levitation 
the Easy Way 


By Peter Neufeld (Germany) and 
Luc Lemmens (Elektor) 





Two similar DIY magnetic 
levitation projects from 
designer Peter Neufeld are 
presented on the Elektor 
Labs pages. In both cases, 

a Lego figure floats in the 
air. Both work on the same 
principle: the strength of 

a magnetic field between 
an electromagnet and 

a neodymium magnet 

is measured with a 
Hall-sensor and the 
electromagnet is controlled 
depending on this measured 
value. The difference 
between the projects is in 
the control circuit. The 

first is “hardware only” and 
uses an analog comparator, 
while in the second, an 
MsStack Atom ESP32 Pico 
microcontroller module is 
used. In this article we focus 
on the first method. 








On Wikipedia, levitation is described as “the 
process by which an object is held aloft, 
without mechanical support, in a stable 
position” [1]. This is accomplished by apply- 
ing an upward force to this object, equal to 
the Earth's gravitational force. Electromag- 
netic force is one of the options if you want 
to design an electronic levitation project. 
In theory, a construction consisting of two 
permanent magnets would do the trick too, 
but because in the real world, there are all 
kinds of disturbing influences that can upset 
this unstable balance, in practice electromag- 
nets are used. A control circuit can then vary 
the strength of the magnetic field to keep the 
floating object in place. This requires some 
kind of feedback on the position of the floating 
object, and in the two projects presented on 
the Elektor Labs pages, a Hall sensor is used 
to measure the strength of the magnetic field 
between an electromagnet (in a fixed position, 
attached to a frame) and a permanent magnet 
that “floats” under it. The output voltage of this 
sensor is used as a measure for the distance 
between the two. The term “control circuit” 
often evokes memories of elaborate, rather 





complex calculations and circuits needed 
to realise a stable control system, but Peter 
Neufeld’s projects show that it does not 
always has to be this complicated. 


Levitation projects are always eye-catch- 
ers. Somehow it is always fascinating to see 
that an object can just float in the air. It looks 
magical, as if the laws of gravity no longer 
apply to the floating object, which is, of course, 
not the case. | found it quite extraordinary 
that it could de done with so little electronics. 
Most other DIY magnetic levitation projects 
I'd seen before Peter's projects looked much 
more difficult to build, often with self-made 
coils, and requiring high currents. Anyway, the 
videos that Peter posted proved that it should 
be possible, even though he already states 
that it takes some precision and dexterity to 
get the calibration right. One way to find out 
if it works: just give it a try! 


This article covers one of the projects, called 
“easy way” [2], and it's the one with the analog 
comparator to control the electromagnet. The 
article will mainly be focused on how the levita- 


tion works. In a following article, the version 
with the M5Stack Atom ESP32 Pico will be 
covered [3], with more focus on the cosmet- 
ics to create a nice looking levitation gadget. 


Hardware for the Analog Version 

The schematic diagram in Figure 1 shows 
that only very simple hardware is needed 
to build this project. L1 depicts the coil of a 
relay, with its switching mechanism removed. 
Itis part of a standard relay board (which will 
be discussed in the following section), that 
is attached to a frame with the core point- 
ing downwards, the levitated object (with a 
permanent magnet) will hover under this coil. 
R6 and LED3 replace flyback diode D4 on this 
PCB and will serve as optical indication during 
calibration of the levitation circuit. Hall sensor 
U1 is mounted on the core and measures the 
magnetic field between L1 and the floating 
object, its output is connected to the invert- 
ing input of comparator U2, an LM311. The 
non-inverting input of U2 is connected to the 
wiper of preset trimmer RV1, which is used 
for adjustment of the control circuit, while R3 
provides a small hysteresis to the compara- 


200311-001 


Figure 1; Schematic diagram of this levitation project. 
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Figure 2: Overview of the finished assembly. 





Figuve Sa: terminal block removed, start vemoving 


the velay cover. 


n 


tor. The output of the comparator switches 
the coil on when voltage at the output of the 
Hall sensor is lower than the preset level on 
the wiper of RV1. 


LED D5 is the power-on indication and SW1 
the power switch. D1 is a so-called crowbar 
diode that protects the circuit if the supply 
voltage is accidentally connected the wrong 
way round. 


Getting the (Right) Components 

Most parts in the schematic and the bill 
of materials are standard components, 
only the A1302 or A1308 Hall sensors from 
Allegro turned out to be a bit more difficult 
to source. But the cheaper and more widely 
available sensors like the SS49 failed to work 








Figuve 3c: Remove the switch contact ana cut 
the cove. 
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Figuve 3A: Relay transformed into electromagnet. 


Figure 3: Modifying the relay (module), 





Figure 4: Hall sensor 
mounted on the core of 
the electromagnet. 


in the early prototypes of Peter's levitation 
projects, probably because the output signal 
does not react quickly enough when the 
magnetic field varies, but this has not been 
investigated further. 


Surprisingly, the most tricky part to get was 
the relay board that is used for the electro- 
magnet. These modules are readily avail- 
able on the internet in dozens of maker and 
Arduino web shops and it shouldn't be any 
problem to find and buy them. Peter had 
tested boards marked HW-482 with JQC-3FF- 
S-Z and JQC3F-05VDC types of relays. | 
(re-)learned a very important lesson when 
shopping on the internet: never trust photos 
in web shops! | looked at the photos that the 
designer posted and found exactly the same 
board on Amazon. | received modules with 
the board marked HW-307, carrying a relay 
with type number FL-3FF-S-Z. They work as 
described and promised in the shop, i.e. a 
5 V SPDT relay boards with driver transis- 
tor, flyback diode and indicator LEDs. But 
the transistor on this board is an PNP type, 
as opposed to the NPN on the relay boards 
Peter tested. | gave it a try anyway, except 
for the type and brand the relay looked very 
similar to the one used in the original project; 
as turned out later, also on the inside. After all, 
for this project, the coil and core of the relay 
are the most important parts. 


For the magnets, a stack of two or three 
disk-shaped neodymium magnets with 


Capacitors 


C2 — 100i 


Semiconductors 


D1 = 1N4001 


a diameter of 8 to 12 mm and 2 to 3 mm 
thickness were used. The size and number 
of magnets needed will also depend on the 
Lego figure or any other load you want to 
attach to them. | started with a stack of two 
magnets only, both 10 mm diameter and 
2mm height, and | would recommend to 
start experimenting with such a simple object 
to get the feeling how to adjust the control 
circuit. It may be a good idea to mark the 





top of the stack with a permanent marker 
or piece of tape to keep the orientation 
right. Once you get that working, you can 
continue with other magnets and adding 
objects (like a Lego figure). Of course, there 
are limits to the size and weight of the load 
that can levitated with this hardware. In this 
article, the term “magnet(s)” will refer to the 
complete load, i.e, the stack of magnets plus 
optional load. 


(CED) 


RV1 = 20 k multiturn trimmer 


C1 = 47 u, 10 V radial 


COMPONENT LIST 

Resistors D2 D5 = red LED 

R1 = 4k7 D3 = white LED 

R2=18k D4* = not mounted (or 

R3 = 220 k remove from relay board) 
R4,R6 = 220 Q oB e550 

Rö = Ik2 U1 = Hall sensor A1302 or 
R7 = ANAC) A1308 (Allegro) 


U2 = LM311 comparator 


Miscellaneous 

5V relay board * 

SW1 = slide switch 
Neodymium disk magnets* 


*= see text 


Assembly 

There is no PCB design for this project, but 
it is easy to build with a piece of Veroboard 
or even on a breadboard. Figure 2 shows an 
overview of the setup of the original proto- 
type. When constructing the hardware for this 
project, start by removing the 3-way termi- 
nal block from the relay board to get more 
space to work on the relay. Take a close look 
at Peter's photographs in Figure 3 to see 
what to do with the relay, essentially: remove 
its cover and most of the switching mecha- 
nism, only the coil and core are used. Shorten 
the U-shaped core to a J-shape to prevent 
magnetic field shortout. Some kind of small 
grinding disk on a Dremel tool may come in 
handy to cut metal parts. 


Whatever type of board you have, the flyback 
diode D4 for the relay must be removed 
and replaced by adding R6 and white LED 
D3. With the relay board Peter bought, the 
rightmost part of the schematic in Figure 1 
is finished then, including Q1, R5 and D2 
that are already installed on the PCB. In my 
case, | only kept the relay coil, removed all 
other components and rebuilt this part of 
the circuit with through-hole parts. A BC550 
for Q1 or any other standard NPN-transis- 
tor will do fine for controlling the relay coil. 
In hindsight, with the boards | received, it 
would have made more sense to just buy the 
relay, but these small, mass-produced relay 
modules are probably cheaper than buying 
a separate relay only. 
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supply when the magnet gets pulled up to 
the core. 


Building the rest of the circuit using the 
modified relay board and an additional piece 
of Veroboard will not be too difficult. But note 
that the wiring of the coil and orientation of 
the permanent magnet and the Hall-sensor 
are very Important to get the magnetic levita- 
tion working: 


> When the permanent magnet comes 
closer to the coil and Hall sensor, the 
output voltage of the sensor must 
increase. 

> When the coil is switched on, its 
magnetic field must attract the magnet. 





If one of these conditions is not met (or both), 
it will not work. The first condition is easily 
checked by measuring the output voltage of 
the Hall sensor using a multimeter; simply 


Figure 5: Final version of my prototype. I’ve done better, but it works. 


Pls note that the references of the parts on 
the relay board in the schematic in (L1, R5, 
D2 Q1 and D4) do not correspond to compo- 
nent references on the PCB. It will not be too 
difficult to identify the flyback diode D4 that 
must be removed. 


The Hall sensor is mounted directly on the 
core of the coil, align it to the center of the 
core’s surface as shown in Figure 4. Glue a 
thin piece of plastic over the sensor and its 
pins to prevent short circuits of the power 





flip the magnet if the voltage lowers when it 
approaches the sensor. And the second one 
... | could feel the force between the powered 
coil and magnet, that seemed to be okay. 


It looked like the control circuit | had built 
was working correctly, since both LEDs were 
lit when they should be: D2 when the coll 
is switched on, D3 flashed when the coil 
switched off as the magnet came closer the 
coil. It should be a matter of trimming RV1 to 
get the correct voltage setting on the non-in- 


USING A POWERBANK AS POWER SUPPLY 


When there is no permanent magnet close to the core and Hall sensor, the coil is permanently switched on and the total current 
consumption of this circuit is approximately 75 mA, which is mainly determined by the current in the electromagnet. When there is 
a magnet hovering under the coil, the average supply current reduces to only 50 mA at 5 V supply 

voltage, which is surprisingly low for a magnetic levitation project. Designer Peter 
Neufeld uses a USB powerbank as power supply, allowing the project to be 
presented on a table or desk without the need to attach a power 
cable, as the powerbank is (part of) the base for the 
bracket that supports the hardware. Most powerbanks 
automatically switch off after a few seconds at 

small loads and 50 mA may be under this threshold, 
depending on the type and brand of powerbank. In 

some cases, it will not work with this kind of power 
supply, but this can easily be fixed by increasing the 
current consumption of this circuit, for example by adding 
one or more power LEDs. 
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verting input of the comparator to get the 
magnet attached to a Lego figure (or any 
other kind of small weight) hovering like in 
the video. But my efforts were in vain: the 
magnet just slammed onto the coil or fell 
down on the table. 


Then | remembered the second condition 
for the levitation to work. | could definitely 
feel that the magnet — when | was holding it 
between my fingers — was attracted to the 
coil when it was powered. That should be 
OK too. Or not? 


If Everything Fails, Read the 
Manual (or Think, or Read Again) 
First, | checked the strength of magnetic field 
of the coil. | was surprised to notice that its 
electromagnetic force appeared to be almost 
negligible: directly powered with a 5 V supply, 
it could hardly pick up the tiniest iron object. 
Not the kind of force you would expect to lift 
anything, let alone a force strong enough to 
make a relatively heavy load like a magnet 
and an object attached to it float. But here | 
overlooked something very important: even 
when the coil is not powered, there Is still 
the static magnetic force between the perma- 
nent magnet of the load and the metal core 
of the coil. This force is much stronger than 
the electromagnetic force of the coil. So the 
trick is: when the permanent magnet nears 
the core, there is a point where the static force 
just isn't strong enough to pull the magnet 
towards the core. This is where the additional 
electromagnetic field comes in: the coil only 
adds a small force to the static field, just 
strong enough to pull the magnet up. The 
magnetic field measured by the Hall sensor 
increases (and thus Its output voltage) as the 
magnet comes closer to the core, switching 
off the coil (with correct adjustment of RV1!) 
and preventing the magnet to be pulled 


Related Products 





> Magnetsphere Kit 
www.elektor.com/magnetsphere-kit 


completely towards the core. Gravity then 
pulls the magnet down, lowering the field 
measured by the sensor, switching the coll 
on again - and so on. 


Since the electromagnetic field is very weak 
compared to the static magnetic field, it is diffi- 
cult to determine if the powered coil attracts 
or repels the magnet. | used an old-fashioned 
compass to confirm if the orientation of the 
electromagnetic field was correct to meet 
the second condition for hovering. When | 
re-read Peter's documentation, | saw that he 
mentioned a simple solution to find the right 
orientation of the coil: the output voltage of 
the Hall sensor doesn't only increase when 
the permanent magnet comes closer, but also 
when the coil is powered (e.g. by connecting 
the collector of Q1 to GND). You may need to 
either swap the connections of the coil and 
LED D3 to get it right. 


Adjustment 

As pointed out earlier, it takes precision and 
dexterity to find the point where the load will 
hover, somewhere in the range of 10 mm 
to 15 mm distance between coil and load. 
Peter describes a procedure of using a stack 
of Post-It notes to get the distance right for 
calibration, but for some reason — my lack of 
precision and dexterity, | guess — this didn't 
work for me. My trick was to put the magnet 
on my hand, very slowly lifting it towards 
the coil until | could feel the magnetic force 
picking it up. If the coil switches off before 
that point is reached, adjust RV1 for a higher 
threshold on the non-inverting input of the 
comparator, or to a lower level if it doesn't 
switch off before the magnet is pulled up to 
the core. The white LED will light briefly when 
the coil is switched off, adjust the potentiom- 
eter to the point where this LED looks to be 
continuously lit (in fact: it will be flashing at the 
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Questions or Comments? 

Do you have technical questions 
or comments about this article? 
Feel free to contact the editor 

at luc.lemmens@elektor.com! 


control frequency of the magnet). At first, you'll 
end up with the magnet stuck to the core, but 
once you get the hang of it, you'll notice that 
it gets increasingly easy to get the calibration 
right for other loads. With my setup, | could 
even hear the switching of the control circuit 
when the setting Is (almost) correct. And yes: 
it may take some time before you get it right, 
but you can do it! 


My first intention was to build a prototype 
that looked at least as good as the one of 
the author, but with all the changes | had to 
make to get it working, | completely failed 
in that respect, as can be seen in Figure 5. 
But my main goal was achieved: | got the 
magnetic levitation working! And maybe some 
day, when | run out of ideas what to do with 
my spare time ... But I'll put more effort in 
cosmetics of the second part that will follow 
in the next levitation project that Peter Neufeld 
has designed, the Digital Solution. With the 
lessons learned from this “simple” analog 
setup, most pitfalls encountered in the analog 
version can be avoided and the second project 
should be easier to do, leaving more time to 
make the hardware look good too! F€ 
200311-01 





[1] Wikipedia page on Levitation: https://en.wikipedia.org/wiki/Levitation 

[2] P. Neufeld, “Magnetic Levitation - The Easy Way,’ ElektorMagazine.com, June 2020.: 
www.elektormagazine.com/labs/magnetic-levitation-the-easy-way 

[3] P. Neufeld, “Magnetic Levitation - The Digital Way,’ ElektorMagazine.com, 
July 2020.: www.elektormagazine.com/labs/magnetic-levitation-the-digital-way 
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Last time, we lit up an LED. Now it’s time to make it blink. We will continue with smart pins 
to form a UART that can transmit characters. Let's take our first steps toward communicating 


with the Parallax Propeller 2! 


In the previous articles in this series, we started coding the Propeller 2 
MCU and we illuminated an LED using SPIN2. Now I will provide you 
with a solution to make it blink, and then | will continue with the IO 
pins. Let's get started. 


A simple solution 
You can follow a simple "turning it off and on again’-scheme. To do 
so, you need the following ingredients: 


> pinwrite() 
> repeat () 
> waitms() 


The necessary steps include: 


> Turn the LED on 
> Wait 500 ms 

> Turn the LED off 
> Wait 500 ms 

> Repeat 


The code will look like what you see in Figure 1. You can download it 
from the article webpage [1]. 


After we have used pins as output, the next step would be to show 
how to use them as inputs. We are not going to do so at this point. 
We will come to this topic, inputs, later. Having a kind of serial data 
output to talk to a PC makes showing what status we have read from 
an I/O pin a lot nicer than just blinking an LED. Furthermore, we can 
use this output to send status data and do some debugging of the 
code. The next stop in this series will be the smart pins. 


Smart pins 

These days, marketing teams like to call products “smart” (e.g. “smart 
city, “smart data,’ and “smart contracts”). With the smart pins, it is a 
different story, as they can be far more than just ordinary general-pur- 
pose IO pins. On other MCUs, you will sometimes have the ability to 
select from multiple functions for one pin. Some MCUs have, like the 
ESP32, an IO matrix that can route any internal IO signal from periph- 
erals to any pin. In these cases an IO pin will still be just an IO pin, the 
functions of — for example — UART, SPI or ADC, will reside inside a 


@ Propeller Tool - P2: LED_Blink 


File Edit Run Help 
P2: LED_Blink | 


(© Full Source ( Condensed 


ub main () 
pinwrite (56, 1) 
repeat 

HeD Propeler Tovi 32 ‘Propeller Tool v1.3.2 J vaitms( 500 ) 
| Be Gnuwin32 

| i~[j} HDSDR v 







pinwrite (56, 1 ) 


AsynSerialTx.spin2 waitms( 500 ) 


LED_Blink.spin2 
LED_On.spin2 
Simple_Spin_Template. spin 
Simple_Spin2_Template. spin2 


pinwrite (56, 0 ) 


Summary 


( Documentation x| 





[all Propeller Source [*.spin/spin2] v | 


Eer | | Inset | 





Figure 1: Code to blink one LED. 
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Custom I/O Pad Ring Synthesized Core Logic 


COG_DAC(Streamers/Cogs) 

















Flash DAC 






28838888 


Even Pin 
(pins 0,2,4...62) 


Odd Pin 
(pins 1,3,5...63) 


Select 
Flash DAC 
Network 
Physical (%6P...P) 


(%A_B_F) 
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Figure 2: Smart pin overview. 


dedicated block of hardware that Is just connected to the pin Itself. 
With the Smart Pins on the Propeller 2, this changes as the dedicated 
peripherals are no longer dedicated function blocks inside the MCU 
that are routed through a IO matrix but integrated, at least partially, 
into every IO pin. Hence the term smart pin. 


Thankfully, the user “rayman” on the Parallax Forum [2] did a great 
job by providing the community with an overview of the smart pin 
internals. You can find his post and the image at [3] or you can also 
have a look at Figure 2. In the “Overview of Smart Pin Functions” 
textbox, | include an extract from the datasheet. You can see that one 
pin can serve for many functions. Currently, we are only interested 
in 11110* = async serial transmit to send out data for later debugging 
purposes. The first step is to figure out how to set the appropriate 
mode for the pin and if it can be done with pure SPIN2 or if we need 
to mix in a bit of Assembly language. 


UART Configuration 

This is the point where you start scratching your head if you are working 
with SPIN2 and the Propeller 2 for the first time. The current datasheet 
is, more or less, complete. But reading and understanding everything 
properly can take longer than expected. Our goal is a simple function, 
a tx(), that will take a character to transmit to a pin working as a 
UART. We will work with 115200 baud, 8 data bits, no parity and only 
one stop bit. The first thing to do is set up the pin. 


You must do the following: 
> Set up the pin in async serial transmit 


> Set the baud rate and data bits 
> Enable Smart Pin 


Overview of Smart Pin Functions 


































































































00000 | smart pin off (default) 

00001 | long repository (P[12:10] != %101) 

00010 | long repository (P[12:10] != %101) 

00011 | long repository (P[12:10] != %101) 

00001 | DAC noise (P[12:10]= %101) 

00010 | DAC 16-bit dither, noise (P[12:10] = %101) 

00011 | DAC 16-bit dither, PWM (P[12:10] = %101) 

00100* | pulse/cycle output 

00101* | transition output 

00110* | NCO frequency 

00111* | NCO duty 

01000* | PWM triangle 

01001* | PWM sawtooth 

01010* | PWM switch-mode power supply, V and | feedback 

01011 | periodic/continuous: A-B quadrature encoder 

01100 | periodic/continuous: inc on A-rise & B-high 

o periodic/continuous: inc on A-rise & B-high / dec on 
A-rise & B-low 

01110 | periodic/continuous: inc on A-rise (/ dec on B-rise) 

01111 periodic/continuous: inc on A-high (/ dec on B-high) 

10000 | time A-states 

10001 | time A-highs 

10010 time X A-highs/rises/edges -or- 
timeout on X A-high/rise/edge 

10011 | for X periods, count time 

10100 | for X periods, count states 

10101 | for periods in X+ clocks, count time 

10110 | for periods in X+ clocks, count states 

10111 for periods in X+ clocks, count periods 

11000 | ADC sample/filter/capture, internally clocked 

11001 | ADC sample/filter/capture, externally clocked 

11010 | ADC scope with trigger 

11011* | USB host/device (even/odd pin pair = DM/DP) 

11100* | sync serial transmit (A-data, B-clock) 





11101 


sync serial receive (A-data, B-clock) 





11110* 


async serial transmit (baudrate) 





11111 


async serial receive (baudrate) 





* OUT signal overridden 


These three simple steps will enable one pin to be a transmitting 
UART pin. As we will later modify the code and reuse it, we put it 
into a function. A function simply contains code or code fragments 
that are used often inside a program. This avoids a copy and paste 
through the code and also allows maintenance to be done at one 
place. We will use a function and call it serial_start. This one will 
take no arguments and simplify to the three steps given above. The 
pin we use is currently hardcoded to be pin 57 (one of the LED pins 
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NZ e a 
it E 
ce Z 
Ho z 
oun = 
Q z 
= QT = BENN 
z >Q w ITT 
= M soararn PUB serial_start () 
= ~ > WRPIN( 57, %01 11110 0 ) “set async tx mode for txpin 
G « WXPIN( 57, ((217<<16) + (8-1 )) ) "set baud rate to sysclock/115200 and word size to 8 
org 
dirh #57 
end 





Figure 3: Location of the pinheader to get access to Figure 4: Code of serial_start(). 


the LED pins. 
PUB tx (val) also accessible at one of the edge connectors as seen in Figure 3). 
Here the function starts with a PUB followed by the name of it. At the 
WYPIN(57,val) ‘load output word y 
org end you have empty braces, showing that we take no arguments. 
WAITX #1 "wait 2+1 clocks before polling busy 
wait PUB serial_start() 
RDPIN val,#57 WC "get busy flag into C , . 
IFC JMP Suait "ass unl oC =o WRPIN( 57, %@1_11110_0 ) 'set async tx mode for txpin 


WXPIN( 57, ((217<<16) + (8-1 )) ) 
'set baud rate to sysclock/115200 andword size to 8 bits 
org 'start of assembly part 


Figure 5: Code for tx function. dirh #57 
end ' end of assembly part 


end 


@ Propeller Tool - P2: AsynSerialTX_OneChar = O x 
| File Edit Run Help 
O AsynSerialTX_OneChar 






















P2: AsynSeriallX_OneChar 
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PUB main () 
pinuwrite (56, 1 ) 


iel ‘4... \Propeller Tool v1.3.2 X 
serial_ start () 


Propeller Tool v1.3.2 


repeat 
waitms( 250 ) 
pinwrite (56, 1 ) 
tx ("0") 





AsynSerialTX_OneChar.spin2 
LED_Blink.spin2 


waitms( 250 ) 
pinwrite (56, Ø ) 
tx ("1") 


PUB serial_start () 
WRPIN( 57, #@1_11110 0 ) "set async tx mode for txpin 
WXPIN( 57, ((217<<16) + (8-1 )) ) “set baud rate to sysclock/115200 and word size to 8 
org 
dirh #57 
end 


PUB tx (val) 


WYPIN (57,val) ‘load output word 


org 
WAITX #1 “wait 2+1 clocks before polling busy 
wait 
ROPIN val,#57 WC “get busy flag into C 
IF_C  JMP #wait ‘loop until C = @ 
end 
Yy 
[all Propeller Source [*.spin/spin2] ka | < > 


| 35:8 Insert | Compiled DAT - 16 bytes A 


Figure 6: Complete code assembled. 


42 July & August 2021 www.elektormagazine.com 





Starting with line 1, you have, as | mentioned above, the function — 
more precisely, the function head. The next line will set the pin 57 into 
async serial transmit, notable at the 11110. The first bit is always zero; the 
two most significant bits shown here as ‘01’ denote that the pin shall be 
driven by the GPIO or Smart Pin function. We use here the SPIN2 WRPIN 
function to achieve our step one. The next function WXPIN writes, for a 
smart pin in async serial mode, the desired clock divider and data bits to 
be used. For simplicity we skip the part with the fraction baud rate divider 
for now. The value for the baud rate can be calculated by systemclock/ 
baudrate — here 25 MHz/115200 baud — resulting in about 217. This result 
needs to be shifted by 16 to the right. For the number of bits to transfer, 
we use the formula (desired bits - 1) and this leaves us with (8 - 1) bits. 


This is all the magic needed to set up the transmission speed and 
data bits. The next three lines look different than the previous code. 
As this is showing a small assembly section, it may require few words 
of additional explanation. With org you can start a section of assem- 
bly instructions, and they are currently needed here. The assembly 
command dirh will enable the smart pin functions, as we need to do 
for our step three. What's different is now how you tell what pin number 
we are working on, as this needs to be started with a ‘#: 


The last line end will end the assembly section. It also at the same 
acts in this special case as the end of the function itself. It would been 
great to avoid assembly but currently there is no SPIN2 equivalent for 
the dirh assembly instruction. The formatted and highlighted code 
can be seen in Figure 4. 





Now that the pin is in the correct mode, we can continue and set up 
a function, one that sends a character and waits until it's done. The 
function can be mostly grabbed from the datasheet [4], page 91. We 
have seen how to build functions that have no arguments, meaning 
nothing passed on to them. To send a character, it would be beneficial 
if we can pass what we like to transmit to the function. As we currently 
try to avoid as much assembler as possible, we will, where possible, 
use the SPIN2 functions instead of inline assembly. 


Transmission 

For transmission, we create a tx function that looks almost identi- 
cal to our serial_start() function, as you can see at Figure 5. 
The visible difference, besides the name, is the argument ‘val’ inside 
the brackets. ‘val’ will carry the character to be printed. Inside the 
function, we will first write the value into the transmission register 
of pin 57 using the WYPIN command. The following section consists 
again of a few lines assembly code. We need to wait until the busy 
flag for the transmitter is no longer set and the transmission is done. 
According to the datasheet, we must first wait three CPU cycles to 
read the flag in a consistent manner. This is achieved by the waitx 
instruction with the #1 parameter, as its execution takes two cycles + 
the amount specified for the function (here one cycle). The next line 
is a label called wait, in assembly language, a place where we later 
can jump to. RDPIN in assembly, as written here, reads the pin status 
with carry. This is denoted by the wc at the end of the statement. The 
carry bit, here serving as busy flag, is important as it denotes if the 
transmission has been completed. 
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RD P I N va ie b] # 9 T WC reads th e status | ncl ud | n g Saleae Logic 1.2.24 Beta - [Connected] - [32 MHz Digital, 2.812 ks] Options v - a xX 











the carry bit into our val value. As the content ape mi a bina 

is currently transmitted, we can repurpose the 00 Len am r ees eee ee ap aes SE 
memory of val to read the smart pin status to it. | — SUES 

The last command IF_C JMP #wait is a condi- J Ja 
tional jump; in basic it would be the infamous P 
GOTO equivalent combined with an IF state- 

ment. Shortly translated it means: Have you read Y Decoded Protocols 
something with the carry bit (here busy flag) set? isi ae: 
Go back to the wait label and start from there orso 
again, or else move on. Our transmission is done AGE 

if the carry bit is no longer set, and therefore the TGR 
function will run to its end and return to where : torah 

it was called. 


Figure 7: Logicanalyzer trace showing every 500 ms a transmitted character. 
Assemble all parts 


We can now assemble the code and insert after 
every pinwrite() to transmit a “0” or “1” by using 





ty (“0”) or tx(“1”) in our code, as shown in Saleae Logic 1.2.24 Beta - [Connected] - [32 MHz Digital, 2.812 ks] 5 aie - ao xX 
Figure 6. To grab the output attach a USB serial a jia Shahi Eau 7 ms | 
converter. For this purpose, we grabbed our trusty i C E O 

Logic 16 and recorded the output of the LED and 

the serial transmission and show the result in esc 


Async Serial 


Figure 7 and Figure 8. 


Y Decoded Protocols 


But how about strings? Would it be nice to just do 


Q Search Protocols 





a print(“Hello World”) and have that trans- TD 
mitted over serial like we can do in the Arduino since 
world? Yes, this can be done and we will. The ees 
next step will be an introduction on this. K . 10x) 
Q= Capture » 32 MHz, 89B... i : ee 

200479-C-01 — 





Figure 8: Zoomed trace showing the character transmitted. 


Questions or Comments? Contributors 

Do you have technical questions or comments about his Design and Text: Mathias ClauBen 
article? Email the author at mathias.claussen@elektor.com or Editors: Jens Nickel, C. J. Abate 
contact Elektor at editor@elektor.com. Layout: Giel Dols 
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Most complex real-time systems require a number of tasks (or 
programs) to be processed almost at the same time. For example, 
consider an extremely simple real-time system that is required to 
flash an LED at required intervals, and at the same time monitor 
for a keypress from a keyboard. One solution would be to scan the 
keyboard in a loop at regular intervals while flashing the LED at the 
same time. Although this approach may work for a simple example, 
in most complex real-time systems a multitasking approach should 
be implemented. 


The term multitasking means that several tasks (or programs) are 
processed in parallel on the same CPU. However, it is not possible 
for several tasks to run on a single CPU at the same time. There- 
fore, task switching is done where the tasks share the CPU time. In 


By Dogan Ibrahim (United Kingdom) 


This installment of Elektor Books presents an 
Appendix excerpted from Dogan Ibrahim's 

book Nucleo Boards Programming with the 
STM32CubeIDE published by Elektor. At the heart 
of all projects described in the book is the Nucleo- 
L476RG development board, which is widely 
available at low cost, and the free STM32CubeIDE 
software. They make a perfect combination for 
pretty advanced embedded applications. Here, 
we make the STM32 micro, the CubeIDE, and Free 
RTOS join forces in a learn-as-you-go project. 


Editor’s Note: This article is an excerpt from the book Nucleo Boards 
Programming with the STM32CubeIDE — Hands-on in More Than 50 
Projects, formatted and lightly edited to match Elektor Magazine editorial 
standards and page layout. Being an extract from a larger publication, 
some terms in this article may refer to discussions elsewhere in the 
original book publication. The author and editor have done their best 
to avoid such instances though, and are happy to help with queries — 
contact details are in the Questions or Comments? box. 


many applications, tasks cannot run independently of each other 
and they are expected to co-operate in some way. For example, the 
execution of a task may depend upon the completion of another, or 
a task may need some data from another. In such circumstances, 
the tasks involved must be synchronized using some form of inter- 
task communication method. 


Real-time systems are time-responsive systems where the CPU is 
never overloaded. In such systems, tasks usually have priorities 
that are obeyed strictly. A task with a higher priority can grab the 
CPU from a lower-priority task and then use the CPU exclusively 
until it releases the CPU. When the higher-priority task completes 
its processing, or if itis waiting for a resource to become available, 
then the lower priority task can grab the CPU and resume processing 
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Figure 1: Circuit diagram of the example application to run Free RTOS on an 
STM32 micro. 


from the point where it was interrupted. Real-time systems are also 
expected to react to events as quickly as possible. External events 
are usually processed using external interrupts and the interrupt 
latency of such systems is expected to be very short so that the 
interrupt service routine is executed as soon as an interrupt occurs. 


It's not too hard to make a list of advantages attributed to the multi- 
tasking kernel: 


> Without a multitasking kernel, multiple tasks can be executed 
in a loop, but this approach results in very poorly controlled 
real-time performance where the execution times of the tasks 
cannot be controlled. 

It is possible to code the various tasks as interrupt service 
routines. This may work in practice, but ifthe application has 
many tasks then the number of interrupts grow, making the 
code less manageable. 

A multitasking kernel allows new tasks to be added or some of 
the existing tasks to be removed from the system without any 
difficulty. 

The testing and debugging of a multitasking system with 

a multitasking kernel is easy compared to a multitasking 
system without a kernel. 

Memory is better managed using a multitasking kernel. 
Inter-task communication is easily handled using a multi- 
tasking kernel. 

Task synchronization is easily controlled using a multitasking 
kernel. 

CPU time is easily managed using a multitasking kernel. 

Most multitasking kernels provide memory security where a 
task cannot access the memory space of another task. 

Most multitasking kernels provide task priority where higher 
priority tasks can grab the CPU and stop the execution of 
lower priority tasks. This allows important tasks to run 
whenever it is required. 


Vv 


v 


v 


v 


v 


v 


v v 
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The Need for an RTOS 

An RTOS (Real-Time Operating System) is a program that manages 
system resources, schedules the execution of various tasks in a 
system, synchronizes the execution of tasks, manages resource 
allocations, and provides inter-task communication and messaging 
between the tasks. Every RTOS consists of a kernel that provides 
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the low-level functions, mainly scheduling, task creation, inter- 
task communication, resource management, etc. 


Most complex RTOSs also provide file-handling services, disk 
read-write operations, interrupt servicing, network management, 
user management, etc. 


A task is an independent thread of execution in a multitasking 
system, usually with its own local set of data. A multitasking system 
consists of several tasks, each running its own code, and commu- 
nicating and synchronizing with each other in order to have access 
to shared resources. Perhaps the easiest example of a multitask- 
ing system is where there are say 3 LEDS and each LED flashes at a 
different rate. The programming of such a simple system without 
a multitasking kernel could be a complicated task. We will see 
in this article how a multitasking operating system such as the 
FreeRTOS can be used to share the MCU resources. 


The simplest RTOS consists of a scheduler that determines the 
execution order of the tasks in the system. Each task has its own 
context consisting of the state of the CPU and its associated regis- 
ters. The scheduler switches from one task to another one by 
performing a context switching where the context of the running 
task is stored and the context of the next task is loaded appropri- 
ately so that execution can continue properly with the next task. 
The time taken for the CPU to perform context switching is known 
as the context switching time and is usually negligible compared 
to the actual execution times of the tasks. 


The FreeRTOS 

FreeRTOS is a real-time operating system that runs on many 
high-end microcontrollers, including the STM32 family. 
STM32CubeIDE has bundled FreeRTOS software, although we will 
not be making calls to FreeRTOS directly. ARM has created the 
CMSIS-RTOS library, which allows us to make calls to an underlying 
RTOS such as the FreeRTOS, i.e. we will be making calls to CMSIS- 
RTOS (version 2) in order to control the underlying FreeRTOS. 


FreeRTOS and multitasking is a very large topic and requires 
several books to explain all of its features. There are several 
books, tutorials, and application notes on the internet that may 
be helpful for readers who are new to the concepts of multitask- 
ing. The book ARM-Based Microcontroller Multitasking Projects 
— Using the FreeRTOS Multitasking Kernel can be very helpful to 
understand the concepts of multitasking and learn to use the 
FreeRTOS in ARM-based MCUs [1]. 


A FreeRTOS Project with the STM32MCubelIDE 

In the remainder of this article, we will develop a simple application 
with 3 LEDs connected to the NUCLEO-L476RG development board. 
The LEDs are named LEDSLOW, LEDMEDIUM, and LEDFAST. The 
connections of these LEDs and their flashing rates are as follows 
(also refer to Figure 1): 











LED Flash rate Connected to GPIO pin 
LEDSLOW every second PCO 
LEDMEDIUM | every 500 ms PC1 
LEDFAST every 250 ms PC2 








A First Program 
The steps to follow are: 


> Start STM32CubelIDE. 

> Select to start a new application. 

> Create a new workspace. 

> Select STM32L476RG as the processor. 

> Name the program: FREE. 

> Configure PCo, PC1, and PC2 as GPIO_Output. Right-click on 
the pins and set the User Labels to LEDSLOW, LEDMEDIUM, 
and LEDFAST respectively (Figure 2). 

> Configure the MCU clock to 80 MHz. 

> Click Middleware on the left-hand side and select FreeRTOS. 

> Set the Interface to CMSIS V2. 

> There are many parameters that can be configured under 
the Configuration tab. The use of these parameters requires 
good knowledge of the FreeRTOS. In this demo project we will 
accept all the default values (see Figure 3). 

> Click File, followed by Save, and click YES to generate code. 

> Click Core, followed by Src, and double click main c to display 
the main program. 


In this program, we will have 3 tasks, also called threads. The basic 
functions in a FreeRTOS program are as follows: 


> define thread IDs; 

> define thread attributes: 
> initialize the scheduler; 
> create threads: 

> start the scheduler. 


osThreadId_t is used to define the thread IDs. The thread IDs in 
this program are: 


osThreadId_t LEDSTaskHandle; // Slow LED 
osThreadId_t LEDMTaskHandle; // Medium LED 
osThreadId_t LEDFTaskHandle; // Fast LED 


The thread attributes define various parameters ofa thread, such 
as its name, priority, stack size, etc. As an example, the thread attri- 
butes for the slow task are: 


const osThreadAttr_t LEDSTask_attributes = 


{ 

.name = “LEDSTask”, 

„priority = (osPriority_t) osPriorityNormal, 
»Stack_size = 128 x 4 

35 


The scheduler is initialized and started with the function calls: 
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Figure 2: Configuring the STM32 chip outputs in STMCubelDE. 
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Reset Configuration 


© Timers and Semaphores © FreeRTOS Heap 
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© Advanced settings Jser Constants ® Tasks and Queues 


© Config parameters © Include parameters 





Configure the below parameters : 


v API 
FreeRTOS API CMSIS v2 
v Versions 
FreeRTOS version 10.2.1 
CMSIS-RTOS version 2.00 
v MPU/FPU 
ENABLE _MPU Disabled 
ENABLE _FPU Disabled 
v Kernel settings 
USE_PREEMPTION Enabled 
CPU CLOCK HZ SystemCoreClock 
TICK_RATE_HZ 1000 
MAX PRIORITIES 56 
MINIMAL_STACK_SIZE 128 Words 
MAX_TASK_NAME_LEN 16 
USE_16_BiT_TICKS Disabled 
IDLE_SHOULD_YIELD Enabled 
USE_MUTEXES Enabled 


USE_RECURSIVE_MUTEXES Enabled 
USE_COUNTING_SEMAPHO... Enabled 


Figure 3: Under Config parameters, accept the default values. 


[1] Dogan Ibrahim: “ARM-Based-Microcontroller-Multitasking-Projects — Using the FreeRTOS’, Newness, 2020 


[2] Cumulative programs download: www.elektor.com/nucleo-boards-programming-with-the-stm32cubeide 
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osKerneLInitialize() ; 
osKernelStart(); 


Threads are created by using function call osThreadNew(). For 
example, the thread for the slow LED is created as follows: 


LEDSTaskHandle = osThreadNew(StartLEDSTask, NULL, 
&LEDSTask_attributes) ; 


Where StartLEDSTask is the name of the function that will be 
called by the scheduler to implement the slow flashing LED. Its 
contents are: 


void StartLEDSTask(void xargument) 
{ 
Port?) 
{ 
HAL_GPIO_TogglePin(GPIOC, LEDSLOW_Pin) ; 
osDeLlay(1000) ; 
J 


Note that instead of HAL_Delay(), we need to use osDelay().HAL_ 
Delay() ina high-priority task might prevent a context switch. But 
osDelay() tells the scheduler to switch to a different task while 
waiting. 


Compile the program in Release mode and drag and drop the 
binary file FREE.bin to device NUCLEO-L476RG. At this point, all 


Listing 1: The FREE program. 


/x USER CODE BEGIN Header */ 
[*x 


three threads will be running simultaneously in their own forever 
loops. The scheduler will switch the threads in and out to give the 
appearance that we are running three threads at the same time. We 
should see the three LEDs flashing at different rates simultaneously. 


The Program! 
Listing 1 shows the program called FREE. The program can be 
retrieved from the free software archive (.zip) file on the Elektor- 
hosted web page for the book [2]. On that page, scroll down to 
Downloads and grab the file called Software _Nucleo Boards Program- 
ming with the STM32CubeIDE. Unzip it on your local drive, and then 
head to the folder FREE. lk 

210236-01 


Questions or Comments? 

Do you have any questions or comments related to this article? 
Then email the author at d.ibrahim@btinternet.com or Elektor 
at editor@elektor.com. 
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x @file = main.c 

x @brief : Main program body 
KKKEKKKKKKKKKKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKKKKKK 
x @attention 

* 

x Copyright (c) 2020 STMicroelectronics. 

x ALL rights reserved. 

* 

x This software component is Licensed by ST under Ultimate Liberty license 

x SLA0044, the «License»; You may not use this file except in compliance with 
x the License. You may obtain a copy of the License at: 

x www.st.com/SLA0044 

X 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* / 

#include «main.h» 

#include «cmsis_os.h» 

// 

// Define Thread IDs 

ye 

osThreadId_t LEDSTaskHandle; 
osThreadId_t LEDMTaskHandle; 
osThreadId_t LEDFTaskHandle; 


// Slow LED 


io) Fast LED 
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// Medium LED 


ia 
// Slow LED task. Flash every second 
// 
void StartLEDSTask(void xargument) 
{ 
for (33) 
{ 
HAL_GPIO_TogglePin(GPIOC, LEDSLOW_Pin) ; 
osDeLlay (1000) ; 


t 
Z 
// Medium LED task. Flash every 500ms 


// 
void StartLEDMTask(void xargument) 


i 
for(;3) 
{ 
HAL_GPIO_TogglePin(GPIOC, LEDMEDIUM_Pin) ; 
osDeLlay (500) ; 
t 
J 
1 
// Fast LED task. Flash every 250ms 
vi 
void StartLEDFTask(void xargument) 
{ 
for(i) 
iE 
HAL_GPIO_TogglePin(GPIOC, LEDFAST_Pin) ; 
osDeLlay (250) ; 
t 
i 


void SystemClock_Config(void); 
static void MX_GPIO_Init(void); 
void StartDefaultTask(void xargument) ; 
// 
// Start of main program 
// 
int main(void) 
i 
HAL_Init(); 
SystemClock_Config() ; 
MSGR TOe Unie): 
i] 
// Slow LED Task attributes 
// 
const osThreadAttr_t LEDSTask_attributes = 


t 
.name = «LEDSTask», 


„priority = (osPriority_t) osPriorityNormal, 


.Stack_size = 128 > 4 
Iie 
V7 
// Medium LED Task attributes 
i 
const osThreadAttr_t LEDMTask_attributes = 
iL 


.name = «LEDMTask», 
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„priority = (osPriority_t) osPriorityNormal, 
.Stack_size = 128 >x 4 


E 

Hy 

// Fast LED Task attributes 

Hy 

const osThreadAttr_t LEDFTask_attributes = 

{ 
.name = «LEDFTask», 
„priority = (osPriority_t) osPriorityNormal, 
.Stack_size = 128 > 4 

Í; 


/x Init scheduler */ 
osKerneLInitialize() ; 


/*x creation of Tasks x/ 


LEDSTaskHandle = osThreadNew(StartLEDSTask, NULL, &LEDSTask_attributes) ; 
LEDMTaskHandLle = osThreadNew(StartLEDMTask, NULL, &LEDMTask_attributes) ; 
LEDFTaskHandle = osThreadNew(StartLEDFTask, NULL, &LEDFTask_attributes) ; 


/x Start scheduler x/ 
osKernelStart() 5 


while (1) 
{ 
T 


void SystemClock_Config(void) 

{ 
RCC_OscInitTypeDef RCC_OscInitStruct = ; 
RCC_ClkInitTypeDef RCC_CLkInitStruct = ; 


REG _OscIinttEStruict, Oscillatorlype = RCC _OSCILLATORTYPE_HSI; 


RCC_OscInitStruct.HSIState = RCC_HSI_ON; 


RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT; 


RCC OscImitStruct.PLL.PLLState = RCC PLE- ON; 


RCC _OscInitStrúct.PLL.PELSoúrce — RCC_PELCSOURCE HSI; 


RCC OscInitStrúuct. PEM PELM = 7; 
RCC _OscInitStruct.PLL.PLELN = 20; 
RCC OscInitStruct. PLL. PEEP = RCC PLLP DIN 7. 
RCC _OscInitStruct.PLL. PELO = RCC PELCO DIN 2; 
RCC OscinitStruct,.PLL.PEER = RCC PLEER DIVZ2; 


if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) 


{ 


Error_Handler() ; 


RCC_ClkInitStruct 


RCC_ClkInitStruct 
RCC_ClkInitStruct 
RCC_ClkInitStruct 
RCC_ClkInitStruct 


{ 


Error_Handler () 


~Clockiype = RCC CLOCKITYPE HCLK|RCC CLOCKTYPE SYSCEK 


. SYSCLKSour 


[RCC CLOCKTYPE PCEKITIRCCCLOCKTYPE PCEK2; 
ce = RCC _SYSCEKSOURCE_PLLECLK; 


.AHBCLKDivider = RCC_SYSCLK_DIV1; 


.APB1CLKDiv 
.APB2CLKDiv 


3] 


ider = RCC_HCLK_DIV1; 
ider = RCC_HCLK_DIV1; 


if (HAL_RCC_ClockConfig(&RCC_CLkInitStruct, FLASH_LATENCY_4) != HAL_OK) 
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if (HAL_PWREx_ControlVoltageScaling(PWR_REGULATOR_VOLTAGE_SCALE1) != HAL_OkK) 
{ 


Error_Handler(); 


static void MX_GPIO_Init(void) 


{ 
GPIO_InitTypeDef GPIO_InitStruct = ; 
/* GPIO Ports Clock Enable */ 
_ _HAL_RCC_GPIOC_CLK_ENABLE(); 
/xConfigure GPIO pin Output Level x/ 
HAL GPIO WritePin(GPIOC, LEDSLOW Pin|LCEDMEDTUM_ Pin|LEDFAST Pin, GPIO PIN RESET); 


/*xConfigure GPIO pins : LEDSLOW_Pin LEDMEDIUM_Pin LEDFAST_Pin >*/ 
GPIO TnitStruct. Pin = LEDSEOW PIN EDMEDTUM PINIELEDFASI PIN; 
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; 

GPIO InitStruct  PULV = GPIO TNOPULL; 
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; 
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct) ; 


void Error_Handler (void) 


{ 


#ifdef USE_FULL_ASSERT 


void assert_failed(uint8_t *xfile, uint32_t line) 
{ 


i 


#endi f 
[KKKKKKKK KKK KKK KKK KKKAKKK (C) COPYRIGHT STMicroelectronics ****xxEND OF FILE*xxx/ 
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Extending 
the MT3608 DC-DC 
Step-Up Converter Module 


By Johannes Sturz (Germany) 


All sorts of interesting electronics modules can be found 
on the Internet for very little money. These modules cover 
about everything from sensors and power supplies to audio 
amplifiers and microcontroller boards, and more. 


One of these modules is a DC-DC step-up 
converter based on the IC MT3608 by 
Aerosem! (Figure 1). It converts an input 
voltage in the range of 2..24 V into a voltage 
at least 0.6 V higher and with a maximum of 
28 V. The output voltage is adjusted with a 
trimmer. The IC can handle up to 2 A (with 
proper cooling, of course). 


To keep the step-up module's circuit simple 
(Figure 2), some features of the IC have 
been disabled, but not in a way that a 
soldering iron cannot overcome. 


Add an Enable Input 

The MT3608 has an enable input to switch 
the IC on and off. When the voltage on the 
enable pin is 1.5 V or higher then the IC 
switches on; when lower, the output voltage 
will be Viy minus the forward voltage of 
Schottky diode D1 (about 0.3 V). 


Having access to the enable pin is useful 
not only because it allows switching the 
module on and off, it also permits PWM 
control. As we will see below, this is practi- 
cal for e.g. controlling the brightness of one 
or more LEDs. 





Figure 1: The cheap MT3608 step-up converter module can generate up to 28 V from an input voltage 
as low as 2 V. The arrow points to pin 4, the enable pin that we are going to use. 


On the step-up module the enable pin 
(pin 4) is connected to the IC's input (pin 5) 
and cannot be used. However, it can if we 


cut the PCB trace between these pins with 
a scalpel (or by lifting pin 4). A magnifying 
glass or a microscope can be useful here. 
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Figure 2: The schematic of the cheap and popular MT3608-based 
step-up converter module. 
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Figure 4: Good LEDs can be recovered from bad 
LED lamps as it is usually the contro! circuit that 
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Figure 3: The MT3608 step-up converter module changed into a dimmable LED driver. To achieve this, 


it is necessary to disconnect pin 4 of the IC from Vy, and to remove the trimmer. 


Constant-Current Output or 

LED Driver 

The MT3608's feedback pin is connected to 
the output voltage by means of a voltage 
divider (P1 & R1). This allows the IC to adjust 
its output voltage so that the voltage on 
its feedback pin remains constant at 0.6 V. 


If the upper part of the voltage divider is 
replaced by one or more LEDs, the step-up 
converter becomes a constant-current 
driver, where the current is determined by 
the lower-half of the voltage divider. This 
is true because the voltage over an LED is 
(almost) independent of the current flowing 
through it, so only the voltage over the 
lower-half part of the voltage divider will 


follow a varying output voltage. This, in turn, 
determines the current flowing through it, 
which is, by Kirchhoff’s first law, also the 
current through the LED(s). 


When the trimmer is removed from the 
module, the IC's feedback pin is discon- 
nected and it can be wired to an external 
current setting resistor (Ret) in series with 
an LED string, see Figure 3. The current is 
calculated with: 


Led = 0.6 / Rief 
Note that the sum of the voltage drops over 


the LEDs plus 0.6 V may not exceed 28 V, 
otherwise the MT3608 will die. 


Example: Dimming LEDs with 
Arduino 

From a broken 9 W LED lamp, the still-func- 
tional LEDs were recovered (Figure 4). This 
lamp was fitted with seven LEDs. However, 
since every LED package contains actually 
three LED chips connected in series, the 
string counts 21 LEDs in total. The voltage 
drop over them is around 50 V (~2.4 V 
per LED) giving an LED current of about 
9 W/50 V = 180 mA. 


A segment of three LED devices makes for 
a string of nine LEDs with a voltage drop of 
some 22 V, which Is within the output range 
of the MT3608. For a current of 180 mA 
through the LEDs, Re = 0.6/0.180 = 3.3 O 
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and it must be able to dissipate 110 mW. The 
LEDs need good cooling to survive. 


With a simple Arduino sketch [1] it is now 
possible to control the brightness of the LEDs 
by sending values from 0 to 255 from the Serial 
Monitor. Pin 9 is configured as PWM output. 


Note that in the actual experiments the 
step-up converter module was powered from 
the USB port. To avoid overloading the fuse 
on the Arduino board, the LED current was 
reduced to 20 mA. For higher currents, an 
external power supply is needed. Also, don't 
forget to cool the MT3608 as Its tiny package 
is only specified for 0.6 W power dissipation. 


This example shows that with a few easy 
modifications a low-cost step-up converter 
module can be turned into a universal LED 
driver. 


Tips: 

> Strictly speaking, it is not necessary to 
remove the trimmer, but it does improve 
efficiency a bit. If you leave the trimmer 
in place, make sure to adjust Voyz to Its 
maximum value. 

> With an output current of 100 to 300 mA 
the efficiency is better than 90%. 

> The voltage drop over the LED string 
must be higher than the input voltage, 
otherwise they cannot be switched off 
completely. 

> When the enable pin is low, the current 
consumption is reduced to a few 





Figure 5: An Arduino Uno and a modified MT3608 
module together control the brightness of an LED 


string. 
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nanoamperes (assuming that the trimmer 
was removed), 
When the modified step-up converter 
is used without the LEDs (e.g, due to a 
bad connection), the MT3608 may get 
damaged (breakdown). A 27 V Zener 
diode between Vour+ and FB can prevent 
this (make sure it can handle the power). 
If the voltage drop over the LED string 
is more than 27 V, split the LED string 
in several segments. Then you can 
either drive each string segment with a 
separate module while connecting all the 
enable inputs in parallel or one module 
can drive all the segments in parallel 
by adding a resistor in series with each 
LED string segment (this will, of course, 
reduce the efficiency). 
It is important to provide adequate 
cooling for the LEDs. Most LED lamps die 
from overheating. Also, provide cooling 
for the MT3608 module. 4 
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Questions or Comments? 

Do you have technical questions or 
comments about his article? Email the 
editor at clemens.valens@elektor.com. 


Contributor: Johannes Sturz 
Editor: Clemens Valens 
Layout: Harmen Heida 








[1] Downloads for this article: www.elektormagazine.com/200308-01 
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Elektor Labs user Hesam Moshiri posts 
video tutorials and projects intended for 
electronics enthusiasts on his YouTube 
channel MyVanitar. 


Component Tester 

Most oscilloscopes have an XY-mode 
that displays the voltage on one channel 
as a function of the voltage on another 
channel instead of as a function of time. 
This mode is used to create the famous 
Lissajous figures, but, with a bit of 
ingenuity, you can also use it as a curve 
tracer to check components. 


This video shows how to use the XY- 
mode in combination with a waveform 
generator and a 10 Q resistor to setup 

a component tester or V-I curve tracer. 
With it you can for instance determine 
the knee voltage of a Zener diode or the 
forward voltage of an unkown LED like 
the ones used elsewhere in these pages. 


www.elektor-labs.com/4243 


12C Decoding 

In another video Hesam shows how to 
use an oscilloscope to decode signals 

on an l?C bus. Even though you will 

need an oscilloscope with serial protocol 
decoding capabilities for this, today 

this option has become quite common. 
Setting it up often requires some fiddling, 
but once you succeed Bob's your uncle 
(as Hesam likes to phrase it). 


www.elektor-labs.com/4281 
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Miniware DT71 


Digital Tweezers 


By Harry Baggen (The Netherlands) 


For the identification and measurement of 


components, so-called measuring tweezers area 
very handy tool. Such measuring tweezers are a 


great solution, particularly when dealing 
with SMDs. The DT71 from Miniware 

can identify and measure all common 
types of passive components 
automatically, and it also offers 

a few additional features. 
Furthermore, the instrument has 
a unique construction witha 
display that can rotate. 





There are various types of “tweezers” available for the identification 
and measurement of (passive) components. The better versions are 
quite pricey, somewhere between €200 and €300. Cheaper versions 
can also be obtained, you could have one for some €20 to €30. 
However, those cheaper tweezers often cannot measure inductors 
and mechanically they are of a lower build quality. When I read 
the list of capabilities that the DT71 from Miniware has to offer, it 
appeared to me that these are great measuring tweezers that really 
offer everything you would expect from such an instrument. And 
while it costs more than one of those inexpensive tweezers, it is 
nevertheless still affordable. 


Design 

The first thing that you will notice when unpacking the DT71 are 
its dimensions. It is 14 cm long and weighs less than 25 grams. 
The device comprises two parts: the tweezers part and the display 


















section with a small OLED display. These are connected together 
using a 4-way, 3.5-mm jack. On the top of the display section is a 
touch sensor that is used to control all the functionality. The display 
section can rotate with respect to the tweezers. Furthermore, there 
is an angle sensor built in that detects whether you are holding the 
tweezers in your left or right hand and adjusts the display orien- 
tation accordingly. The entire device is made from plastic and has 
a nice finish. 


The measurement arms contain red and blue polarity indicators. The 
metal measuring tips are gold-plated and are replaceable. A remark- 
able feature are the springs in the measurement arms. Instead of 
using a mechanical spring for keeping the measurement arms apart, 
two pairs of magnets are used, where two magnets attract one another 
and two magnets push apart from each other. This arrangement 
of the pairs of magnets results in a very smooth springing action. 
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Figure 1: The DT71 comprises two parts and is supplied with a set of spare 
measuring tips and a special charge/connection cable. 


The DT71 is supplied in a small plastic box (Figure 1) that contains, 
besides the tweezers and display parts, a set of spare measuring 
tips and an adapter cable with a USB-C connector. The adapter is 
used for charging the built-in lithium batteries (Figure 2) that are 
housed in the tweezers part and for connecting the display part to 
a computer (for altering the settings and firmware upgrades). A 
USB cable and mains adapter are not supplied, but most of us will 
have these laying around somewhere already. 


Measurement Capabilities 

The manufacturer has tried very hard to fit as many measure- 
ment capabilities as possible in the DT71. For starters, there are 
the component measurements. You can measure resistors, diodes, 
capacitors and inductors. In the Auto setting, the instrument will 
search which type of component is most likely and shows its value 





Figure 2: Display and tweezer parts can be connected like this and charged 
via a USB-C cable. 
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on the display. Furthermore, the DT71 can measure frequency up 
to 20 MHz and DC voltages up to 40 V. 


Additionally, there is also a simple frequency generator built 
in that can generate sine, noise and pulses with a peak-to- 
peak value of about 3 V. There is even a user setting for 
arbitrary wave shapes (100 points maximum). This 
does require connecting the display section to a PC 
and modifying the CAL. INI file in the memory of the 
tweezers (Figure 3). This has to be done in hexadecimal 
notation. Nice, but to me it doesn’t appear all that straightfor- 
ward to quickly define a waveform this way. A small supple- 
mental program would have been very handy! 


The CAL.INI file also contains a few parameters that you can adjust 
as you desire, such as the amount of time when the instrument will 
automatically switch itself off, the display orientation, the display 
brightness and the various pre-programmed frequency values for 
the sine, user and pulse signals. All the settings options are detailed 
in the manual, which can be found, as well as the latest firmware, 
on the forum at Miniware [1]. 


In Practice 

I have tested the DT71 with a handful of components (leaded and 
SMD) from my collection and compared it with another component 
tester and an accurate multimeter. Miniware specifies an accuracy 
of 0.5% for resistors, 2% for capacitors, 5% for inductors and 1% 
for DC voltages. This is more than adequate for the identification 
of components. It only shows 3 digits (in some cases 4) anyway. 


When working with the DT71, I noticed that the display (Figure 4) 
is nice and sharp but very small. I would have liked it to bea 
little bigger. The springy behaviour of the tweezer arms with the 
magnets is very pleasing, but the metal measuring tips are not 
sharp enough. These easily slip off the component, particularly 
when it is soldered on a circuit board. However, the manufac- 
turer has indicated that different types of measuring tips will be 
available in the near future. 


| SLEEP_TIME=60 

| DISPLAY_DIRECTION=4 

OLED_BRIGHTNESS=2 

SINE_FREQ_OPT=0 

NOISE_FREQ_OPT=1 

USER_FREQ_OPT=2 

PULSE_FREQ_OPT=3 

USER_WAVEFORM = { 
@x7FF, @x87F, @xSFF, @x97E, @x9FC, @xA77, OxAF®, @xB66, @xBD9, exc4s, 
@xCB2, @xD18, @xD78, @xDD3, @xE29, @xE77, @xEC@, @xFO1, @xF3C, exFéEF, 
@xF9A, @xFBE, @xFDA, @xFEE, @xFFA, @xFFE, @xFFA, @xFEE, @xFDA, @xFBE, 
@xF9A, @xF6F, @xF3C, @xFe1, @xECe, @xE77, @xE29, @xDD3, @xD78, exD1s, 
@xCB2, @xC48, @xBD9, @xB66, @xAF@, @xA77, Ox9FC, Ox97E, OxSFF, 0x87F, 
@x7FE, @Xx77E, Ox6FE, @x67F, 0x601, 0x586, Ox5@D, 0x496, 0x424, Ox3B5, 

| @x34B, @x2ES, @x285, @x22A, @x1D4, @x186, @x13D, @x@FC, @x@C1, exese, 

| 0x063, @x@3F, 0x023, @xO@F, 0x003, OXO, 0X003, OxOOF, 0x023, exO3F, 

0x063, @x@8E, @xOC1, @xOFC, @x13D, 0x186, @x1D5, @x22A, 0x285, 0x2E5, 

| @x34B, @x3B5, 0x424, @x497, @x5@D, 0x586, Ox601, 0x67F, Ox6FE, Ox77E, 

0x020, @xe20, Oxee2, @xee8, OXOOO, OxOOG, Oxeee, ex2ee, exEe0, exeeE, 

| 0x000, @x80, OxXOOO, OxXOOO, OxXOOO, OxOOO, OxOOO, x200, OxOOO, exo00, 

| 0x000, 0x000, 0x02, exee8, OxOOO, OxXOOO, OXOBA, OxOGO, 

} 


tv MV HV RL RM RH cCx1 CX2 Cx3 Cx4 CxS 
Cx6 CX7 cxs cx9 CH1 CH2 LX1 LX2 LX3 Lx4 LXS LX6 
CALRB_K@ = -1.856, 5.286, 109.890, -10.059, -9.349, 167.794, -5.263, -5.263, -5.263, 0.000, 0.009, 
| 0.000, 0.000, 0.000, 0.000, 6.000, 6.000, 6.000, 6.800, -000, 8.000, - 680, 
|CALRB_K1 = 1.045, 1.011, 1.009, 1.020, 1.021, 1.008, 1.000, 1.600 1.000 1.000, 1.000, 
» 1.000, 1.000, 1. > > > 


— 2 2 
1.000 1.000, 1.000 1.000, 1.000, 1.000, 1.000, 1 





Figure 3: The configuration file CAL.INI contains a number of user- 
configurable parameters, a hexadecimal table for the arbitrary waveform 
generator and a few calibration values. 





Figure 4: The OLED-display usually only shows the value, but in the Auto 
setting a secondary value sometimes appears as well, as with this inductor. 


I find that the most important function of such a tweezers instru- 
ment is its ability to identify the component type. With SMDs in 
particular, you often cannot recognise what they actually are. The 
DT71 appears to do a very good job here. There are a few situations 
where it goes wrong. These are mainly those components where 
the difference between inductance and capacitance are difficult to 
distinguish (for example, with very small inductance values). But 
here I have to mention that this is not entirely without problems 
with other component testers either. If you know what type of 
component it is and you switch to manual operation, then the 
correct value is shown. 


The accuracy turns out to be much better than I expected. With 
resistors and inductors, it was well within the specifications. With 
capacitors, the measurement results from the various testers were 
several percent apart. This has to do, among other things, with the 
measurement method that is used. The DT71 generally indicated a 
few percent too low, but it was certainly not bad. The inductors that 
were measured were all within a tolerance of 5%. With diodes you 
have to check that the polarity is correct with respect to the plus 
and minus tips; otherwise, the DT71 doesn't indicate anything. An 
LED flashes when it is connected correctly, but this measurement 
doesn’t work with blue and white LEDs, because the measurement 
voltage isn't high enough for these. 


With DC voltages my device was only 0.1% wrong. Here too you 
have to keep an eye on the polarity; otherwise, the meter indicates 
“Negativ”. The accuracy of the frequency measurements was well 
within 0.1%. The signal generator generates a sine waveform that 
has the peaks flattened somewhat and you can also clearly see the 
quantising steps, especially at lower frequencies (Figure 5). It is 
therefore not immediately suitable for audio measurements, but 
in any case, it is certainly usable as a test signal. The pulse signal 
is in reality a square wave, which still has a good shape at 100 kHz. 


I found the DT71 very nice to use. It automatically turns on when you 
pick it up (from software version 1.08), and the display orientation 
turns around automatically when you put it in your other hand. The 
spring pressure between the arms is very slight and that makes these 
tweezers, combined with its light weight, very convenient to use. 


SIGLENT 


M 20.0us/ Delay:0.00s 
Sa 1.00GSa/s 


Curr 260kpts 


1X 500m 


-1. 40 


Figure 5: The output signal from the signal generator, the sine (here 5 kHz) 
is somewhat flat-topped and the quantising steps are clearly visible. 


A Versatile Instrument 
The DT71 from Miniware is a very convenient smart tweezers 
measuring instrument that not only identifies various passive 
components, but also offers many additional features such as 
frequency and voltage measurements. It can function as a mini 
signal generator as well. The construction of the DT71 is very unique 
with its two-part design, rotatable display and magnetic springs. My 
only criticism is that I found the display somewhat small; it could 
have been alittle bit bigger. But otherwise, the DT71 is a versatile 
measuring instrument that any electronics enthusiast would be 
only too pleased to receive on their birthday! I 

210182-01 
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[1] Miniware Forum: 
https://minidso.com/forum.php?mod=viewthread&tid=4244 


Questions or Comments? 
Do you have any technical questions or comments prompted by 
this article? Send an email to the editor at editor@elektor.com. 
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Translation to English: 
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> Miniware DT71 Mini Digital Tweezers 
www.elektor.com/miniware-dt71-mini-digital-tweezers 
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ESPHome Does the Job Again! 


By Clemens Valens (Elektor) 


You know these boxes full of boards you 

keep around for some future when you 

will have more time? Having a need for an 
ESP8266 module for my home automation 
experiments, I had a look in some of these 
and found an ESP8266-based “Wearable” 
board I developed some years ago. Nothing 
spectacular, basically just an ESP-12E module 
with a USB-to-serial bridge on it, and a driver 
for an addressable WS2812-based LED string. 
For this part of our series, I brought this board 
to life — of course with the help of ESPHome! 


Several years ago, a colleague asked me to design a wearable micro- 
controller board with an ESP8266-based Wi-Fi module on it; he would 
do the firmware side of the project as he had great plans for such a 
device. When | had the prototype ready, he gave the board a try and 
then left the company. Had my design disappointed or discouraged him 
that much? | never found out. 
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The project was abandoned, and it would have faded into oblivion if — 
fast forward to a few months back — | hadn't had an urgent need for 
an ESP8266 module for my home automation experiments. Searching 
through boxes filled with stuff that might come in handy someday, | 
stumbled upon my wearable ESP8266 prototype. And, as | was obsessed 
with ESPHome [1] at that time, | immediately knew that | now had the 
tools to finally create the software for this board. 


A NodeMCU-Like Circuit 

The schematic of the board (Figure 1) is basically a NodeMCU with the 
CP2101 USB-to-serial bridge from Silicon Laboratories (a.k.a. Silabs) 
replaced by the much cheaper FT231XS from FTDI. Also, a port for an 
addressable WS2812-based LED string (NeoPixels if you prefer) has 
been added. 


As the wearable gadget is almost a NodeMCU, everything that follows 
is also valid for a normal NodeMCU module. The presented software 
works equally well too. 


*8V Lp1117as33 *3¥3 


+3V3 +3V3 +5V 


© © 





VCCA VCCB 


74LVC1T 
45GW 


GND 


TXD 

3V30UT 

RESET DTR 
IC1 CTS 

USBDM RTS 

USBDP DSR 


FT231XS mR 
RI 


CBUS1 
CBUS2 
GND GND 


CBUSO 
CBUS3 
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Figure 1; Circuit diagram of the wearable ESP8266 board. 


The available GPIO ports and power supply are brought out on special 
pads with large holes placed in a circle at the edge of the round board. 
These pads are intended for use with conductive thread, but you can, 
of course, also solder wires to them or use crocodile clips. 


Power for the circuit is supplied by either the micro-USB port or by 
connecting an external 5V power supply to one of the 5 V pins. This is 
useful when using long LED strings as they demand more power than 
a normal USB port can provide. A high-capacity USB power bank Is 
also an option. Note that the LED interface is for 5 V strings. Also note 
that the 5 V input does not have reverse-polarity protection. 


Software Design with ESPHome 

For my experiments, | connected a ring-shaped string of twelve WS2812 
LEDs to port K2, see Figure 2. Of course, you can write the software for 
this board from scratch, like my former colleague planned to do, and 
probably had to as there was not as much ESP8266 code available as 
there is today, but adopting an open-source project like ESPHome saves 
you a huge amount of work. 





Figure 2: The prototype of the 
Wearable Wi-Fi Gadget equiped with 
a 12-pixel addressable RGB LED ring. 
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Listing 1. The YAML Configuration File [2]. 


# Elektor 160112 Wearable ESP8266 
# Configuration file for ESPHome 


esphome: 
name: wearable 
platform: ESP8266 
board: nodemcu 


wifi: 
ssid: "my_ssid" 
password: "my_passphrase" 
ap: 
ssid: "Wearable Fallback Hotspot" 
password: "12345678" 


captive_portal: 


# Enable logging 
logger: 


# Enable Home Assistant API 
api: 


# Enable Over-the-Air updates. 
otak 


output: 

- platform: gpio 
id: "blue_led" 
pin: 

number: GPIO16 
inverted: True 


light: 

= platform: binary 
name: "Blue LED" 
output: "blue_led" 

- platform: neopixelbus 
name: "Light Ring" 
num_leds: 12 
type: GRB 
pin: GPLO2 
method: ESP8266_UART1 
effects: 


addressable_color_wipe: 
name: "Color Wipe" 
- addressable_fireworks: 
name: "Fireworks" 
- flicker: 
name: "Flicker ALL" 


addressable_flicker: # Doesn’t work? 


name: "Flicker Individually" 
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- addressable_rainbow: 
name: "Rainbow" 

- random: 
name: "Random ALL" 

- addressable_scan: 
name: "Scan" 

- strobe: 
name: "Strobe ALL" 

- addressable_twinkle: 
name: "Twinkle" 

- addressable_random_twinklLe: 
name: "Twinkle Random" 


# GPIO11 is somehow related to flash and should 
not be used. 
switch: 

-= platform: gpio 
name: "GPIO4" 
pin: GPIO4 

=- platform: gpio 
name: "GPIO5" 
pin: GPTOS 

= Platform: gpio 
name: "GPIO12" 
pin: GPTOI2 

= platform: gpio 
name: "GPIO14" 
pin: GPIO14 

= platform: gpio 
name: "GPIO15" 
pin: GPTOTS5 


# Pushbutton on GPIOO. 
binary_sensor: 

—- platform: gpio 
name: "Flash" 
pin: 

number: GPIOO 
inverted: True 


sensor: 
= platform: ade 

name: "Analog Input" 

pin: AO 

update_interval: 60s 

Filters: 

- multiply: 3.2 # voltage divider is 100k/ 

(220k+100k) 








75% 
Light Ring 





Blue LED 


Figure 3: These cards in Home Assistant allow controlling the LED ring and the blue LED of the wearable Wi-Fi gadget. 


I've said it before, and | will repeat it once again, ESPHome lets you 
create a connected application for the ESP8266 or ESP32 featuring 
over-the-air (OTA) programming, fallback hotspot, webserver user inter- 
face, and interfaces for over 200 devices in minutes. Really. Refer to [1] 
for more details. 


ESPHome uses a modular approach where ready-made code blocks 
are combined to form an application. The blocks required by the appli- 
cation are listed in a configuration file, the so-called YAML file (YAML 
comes from "Yet another markup language” and is not a language but 
a set of text file formatting rules to specify parameters and values [1]). 
Each block is configured individually, to specify for instance the GPIO 
pin(s) it should use, or the communication protocol or its type. 


The configuration file is read by ESPHome and turned into C++ code, 
which is then compiled into an executable that can be programmed into 
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Figure 4: The light 
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in the ESPHome 
YAML configuration 
file show up as a list 
in Home Assistant 
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the module's flash memory. Once you have understood how to compose 
a configuration file, you're in business. Please refer to [1] for more details. 


A Close Look at the Configuration File 

The YAML configuration file (Listing 1) starts with the obligatory 
esphome: a section to specify a name, the MCU used (ESP8266) and 
the board type (NodeMCU). 


Next comes the Wi-Fi section to specify the network to connect to 
and rescue options in case of network problems. Note that the order of 
sections has no importance. 


Specifying the logger: option activates the status output on the serial port. 
The api: option enables easy integration with the free and open-source 
home automation controller software Home Assistant (see [1]). And 
ota: is for over-the-air device programming (from e.g. Home Assistant), 
which is very practical as it removes the requirement of having a physi- 
cal connection to the device. 


Next comes the meat of the application, starting with the specification 
that GPIO16 must be an output. This is needed if you want to use the 
LED that is connected to it as a light device, which is interesting - as 
lights have different options as for instance switches (Figure 3). 


Lights 

As lights | defined the blue LED on GPIO16 and the LED string. The 
latter is handled by the neopixelbus platform, which has a few options 
that must be specified like the length of the string and the port it is 
connected to. In this case the port is GPIO2 which allows the use of 
the ESP8266_UART1 method. Actually, when specifying this method, 
you don't have to specify GPIO2 as it is implied. 


Lights can have effects, and ESPHome has a few built in that you can 
use (if your light supports them, of course). It goes without saying that 
you can also program your own light effects. | specified most of the 
built-in effects for the LED ring. Effects can have parameters but without 
them default values will be used. Home Assistant lets you choose which 
effect is active (Figure 4). | like the random twinkle effect. 


(©lektor July & August 2021 61 


Other In- and Outputs 

The unused GPIO ports are declared as switches so you can toggle 
them on and off from within Home Assistant. In home automation, 
a switch is a device that is controlled by the system (e.g. a relay). A 
switch that is controlled by the user (or occupant) Is a binary sensor. 
GPIOO has a pushbutton connected to it and therefore it is specified 
as a binary sensor. 


Finally, the board has an analogue input on pin AO with a voltage 
divider in front of it (R15 & R16), which explains the multiplication 
factor of 3.2 that converts the divided input voltage back to volts. The 
maximum input voltage Is 3.3 V. 


Build a Social Distancing Alarm 

ESPHome features automation and you could, as an example, add a 
proximity sensor to the board to change the colour of the LED ring 
depending on what the sensor sees. This way the board could for 
instance be a social distancing alarm. It can also just be a decorative 
electronic pin or brooch; let your imagination go wild. 


An interesting possibility here is to use Home Assistant. With a few of 
these wearable ESP8266 boards integrated in Home Assistant fancy 
lighting effects (e.g., for Christmas) can be created. But, even though 
Home Assistant is optimised for home automation, it can also do other 
things, like controlling a game at the birthday party of your toddler. 
Stick a board on every kid and use Home Assistant to create and 


(CED 


Related Products 





> ESP-12F, ESP8266-based Wi-Fi module 
www.elektor.com/esp-12f-esp8266-based-wi-fi-module-160100-92 


> NodeMCU ESP8266 microcontroller board 
www.elektor.com/nodemcu-microcontroller-board-with-esp8266-and-lua 
> H. Henrik Skovgaard, loT Home Hacks with 


ESP8266, Elektor, 2020 
www.elektor.com/iot-home-hacks-with-esp8266 


control teams or decide which candidate may answer a question or 
who Is ‘it’ when playing tag. | am sure that with a bit of creativity lots 
of fun applications can be invented. 


The design files can be downloaded from [2]. I< 
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Questions or Comments? 

Do you have technical questions or comments about his 
article? Email the author at clemens.valens@elektor.com or 
contact Elektor at editor@elektor.com. 


Contributors 

Idea, Design, Text and Editor: Jens Nickel, C. J. Abate 
Photographs: Clemens Valens Layout: Harmen Heida 
Schematic: Patrick Wielders 


COMPONENT LIST 

Semiconductors 
Resistors D1 = MBRS540 
All 5%, 50 V, 0.1 W, 0603 IC4 = 74LVC1T45GW 
R20 =0Q9 IC1 = FT231XS 
R1,R2 = 270 C2 = LD1117AS33 


R11,R13,R21,R22 = 470 QO 
R3,R4,R5,R6 = TKO 
R7,R8,R9,R10,R17,R18,R19 = 10 kO 


R16 = 100 KQ 
RIS = 220 © 
Capacitors 


C1,C2 = 47 pF, 0603 

C3,C4 = 100 nF, 0603 

C6 = 1 pF, 0603 

C5,C7,C9 = 10 pF, 16 V, Case-A 


—— WEBLINKS 


LED1 = LED, blue, 0603 
LED2 = LED, yellow, 0603 
LED3 = LED, red, 0603 
T1T2 = BC847C 


Miscellaneous 

K1 = Micro USB Type B receptacle, bottom 
mount 

K2 = 3-pin pinheader, 01" pitch 

S192 = Tactile switch, 51 mm x 51 mm 

MOD1 = ESP-12F 

PCB 160112-1 








[1] C. Valens, “Home Automation Made Easy,’ Elektor, Sep/Oct 2020. : www.elektormagazine.com/200019-01 
[2] Wearable Wi-Fi Gadget at Elektor Labs: www.elektormagazine.com/labs/4382 
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BASIC COURSE 









By Eric Bogers (Elektor) 


In the previous instalment 
[1] we saw how capacitors 
block DC but allow AC to 
pass through. But that most 
certainly isn't the end of 

it - voltage and current 
also go out of phase with 
each other, and that can 
make calculations a little 
bit trickier. But that is nota 
good enough reason to be 
scared away! 


Phase angle 

Phase? What is that? To make that clear, we 
briefly return to our humble resistor. When we 
apply a voltage across a resistor, a current will 
flow immediately. Here voltage and current 
are in phase: the instant that the voltage 
increases, the current also increases, and 
the other way around. 


However, with a capacitor this is different, and 
we can explain that as follows. The very instant 
that we apply a voltage across a discharged 
capacitor, it behaves as if it were a short circuit: 
the maximum charging current will flow, but 
the voltage across the capacitor Is zero (as 
is the proper behaviour of a short circuit). As 
the capacitor charges, the voltage across it 
increases while the current decreases. Once 
the capacitor is fully charged, the voltage 
across It has reached its maximum value 
while the current has reduced to zero. So in this 
way we can Say: first there is the current, and 
then follows the voltage. In technical jargon: 


tarting Out 
n Electronics (8) 


Easier Than Imagined! 
This Concludes the Subject of “Capacitors’ 


the current /eads the voltage. When a pure 
sine-wave voltage is applied across a capac- 
itor there is a phase difference of exactly 90° 
between the voltage and the current. 


When we apply an AC voltage across a 
capacitor, an AC current will flow through 
that capacitor — we already saw that previ- 
ously. And that means that we can also 
calculate an (AC-)resistance for that capac- 
itor. Although this is not called resistance 
any more, but is called impedance instead, 
for which the symbol X is used. The unit of 
impedance is again the ohm. The following 
expression applies (we won't trouble you with 
the derivation): 


an 
2:a-f-C 


The bigger (‘fatter’) the capacitor, the more 
charge it can store and the greater is the 
amount of current that flows when that capac- 









I 





itor charges up - and the smaller is its imped- 
ance. Also true: the higher the frequency, the 
more often (per unit of time) the capacitor is 
charged and discharged, the more current 
flows and again: the smaller is its impedance. 


The important thing you have to remember 
is: the impedance of a capacitor is not a fixed 
value, but is dependent on the frequency. 


You can, of course, shrug your shoulders and 
think: “Okay, that’s all very nice, that phase 
difference, but | won't lose any sleep over 
that.” If it was only that simple... In practical 
electronics applications, capacitors and resis- 
tors are seldom used by ‘themselves’; more 
often than not we will be dealing with a series 
or parallel connection of different compo- 
nents. And you can blame that phase differ- 
ence that in, for example, a series circuit of a 
capacitor and a resistor, you cannot simply 
add the impedance and the resistance; these 
have to be added vectorially. 
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Xc Xtot 


Figure 1; Series circuit of a resistor and a 
capacitor. 





Figure 2: Parallel circuit of a resistor and a 
capacitor. 


We will demonstrate that with the example of 
a series circuit consisting of a capacitor with 
a value of 01 uF and a resistor with a value of 
10 kQ, We would like to know the total imped- 
ance at a frequency of 50 Hz. 


First we calculate the impedance of the 
capacitor: 


X ¢ = tf = 
2-m-f-C 
— |! gs g30K0 
2-2-50Hz-0.1uF 
For the total impedance of the series circuit 
the following holds: 


Aoi E JX +R? = 
(31.830kQ)? + (10kQ)? =33.364kQ. 


The total impedance that is calculated this 
way is often indicated with the letter Z (instead 
of Xot): 


The impedance Z also has a certain phase 
angle (which is logically somewhere between 
the -90° of the capacitor and the 0° of the 
resistor). The following holds: 
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tan o = de 
P R 


The phase angle is then (sorry, you will proba- 
bly need a 'scientific’ pocket calculator for 
that): 


= arctan am 
r R 


acan 9 = —72.56° 
10 kQ 


In a series circuit the same current flows in 
all the relevant components; however, in a 
capacitor the voltage lags the current, and 
that is why the phase angle is negative. If 
so desired, this problem can also be solved 
graphically (Figure 1). Because the direc- 
tion of rotation (in the mathematical sense) 
is anti-clockwise, the negative phase angle 
has to be drawn downwards. 


Naturally, a resistor and a capacitor can also 
be connected in parallel; The total impedance 
Z is then (we're using the same components 
and frequency as for the series circuit): 





=9.54 kQ 





+ 
(31.830kQ)?  (l0kQ)? 


For the phase angle we then have: 


R 
o = arctan — = 
C 
egies =17.44° 
31.830kQ 


Here too a graphical solution is possible, see 
Figure 2. In a parallel circuit the same voltage 
is applied across all the relevant components. 
However, the current through the capacitor 
leads the voltage, so in this case the phase 
angle is positive and drawn upwards. 


A final remark, the difference between the 
phase angles in a series circuit and a paral- 
lel circuit (with the same components) Is 
exactly 90°, 


High- and Low-Pass Filters 

In the Elektor issues of September/October 
2020, November/December 2020 and 
January/February 2021, we dealt extensively 
with (the design of) filter circuits. However, for 
the beginning electronics hobbyist these three 
articles were probably a little bit too much of 


a good thing... Nevertheless, filter circuits in 
electronics are of eminent importance. That 
is why we will touch briefly on that subject 
here, without too much of the theory. 


From the formula for the impedance of a 
capacitor, it follows that this impedance at 
a frequency of 0 Hz (that is, a DC voltage), 
goes to infinity, and becomes smaller as the 
frequency increases. That is why a capacitor 
is used to remove (block) the DC part from a 
‘mixture’ of DC and AC voltages. 


We need such a circuit, for example, at the 
input stage of a microphone amplifier: the AC 
voltage (the electric equivalent of the acoustic 
signal) that is generated by the microphone, is 
superimposed on the DC voltage that is used 
to power the microphone (we are speaking of 
a phantom supply; the advantage is that no 
separate cables are required for signal and 
power supply). We obviously do not want to 
amplify the power supply voltage, only the 
signal voltage. 


To remove this DC voltage we use a high-pass 
filter (Figure 3), it is named that because it 
allows the high(er) frequencies through and 
blocks the low(er) frequencies. 


In Figure 4 we see the frequency and phase 
characteristics of a high-pass filter; the 
measuring system that was used for making 
these graphs is unfortunately not particularly 
accurate at the extremes of the frequency 
range. Nevertheless we can clearly distin- 
guish three regions: 


> the pass-band region starts (in this 
graph) at about 1 kHz. In this region the 
signal passes practically unimpeded, and 
there Is also hardly and phase shift; 

> the stop- or blocking-region is below 
about 100 Hz. Here the signal dimin- 
ishes with decreasing frequency - to be 
exact at 6 dB per octave or 20 dB per 
decade; the phase here approaches 90° 
asymptotically; 

> between both these regions there Is 
the corner or cut-off frequency. This is 
defined as the frequency it which the 
signal level is reduced by 3 dB compared 
to the pass-band. At the corner 
frequency the capacitive impedance Is 
equal to the value of the resistor, so that 
we can write: 


1 


Jas RC 


The behaviour of a simple filter such as this 
cannot be specified any further than just the 
corner frequency; this would require ‘multi- 
ple stage’ filters (‘higher-order filters’). This 
material has already been extensively dealt 
with in the aforementioned series of articles 
in Elektor [2], 


Where high-pass filters exists there are also 
low-pass filters. These look the same, only the 
resistor and capacitor have swapped places 
(see Figure 5). The higher the frequency, the 
more the signal is shorted to ground through 
the capacitor. This kind of filter is used for 
(among other things) removing high-fre- 
quency noise from a signal. 


In Figure 6 you can see the frequency and 
phase characteristic of a low-pass filter (in 
this specific case different component values 
were used than in the example of Figure 4). 
Here too we can distinguish three regions: the 
pass-band region below the corner frequency, 
the stop-band or blocking region above the 
corner frequency and the corner frequency 
itself, where the capacitive impedance is equal 
to the value of the resistor. 


With this we conclude our description of capac- 
itors. Next time, we will continue with inductors 
— components that are (unfairly) detested by 
many electronics enthusiasts.. I 

210183-01 


The series of articles “Starting out in electronics” is based 
on the book “Basic Electronics Course” by Michael Ebner, 
published by Elektor. 


Questions or Comments? 

Do you have questions or comments 
regarding this article? Then email 
Elektor at editor@elektor.com. 


=_—_ WEBLINKS 


Figure 3: High-pass filter. 





Figure 5: Low-pass filter. 





Figure 4: Frequency and phase characteristics of 


a high-pass filter. 





Contributors 

Idea and illustrations: Michael Ebner 
Text and editing: Eric Bogers 
Translation: Arthur de Beun 

Layout: Giel Dols 


Figure 6: Frequency and phase characteristics of 
a low-pass filter. 


RELATED PRODUCTS 





> B. Kainka, Basic Electronics for 
Beginners, Elektor 2020. 

www.elektor.com/13950 

> B. Kainka, Basic Electronics for 


Beginners (E-Book), Elektor 2020. 
www.elektor.com/18232 


Ode Electronics 80d Microcontrollers Proj 
Basic Electronics 70% 
or Beginners 








[1] E. Bogers, “Starting out... ;’ Elektor, May/June 2020: www.elektormagazine.com/magazine/elektor-146/58553 


[2] A. Rosenkranzer, “Analogue Filter Design,’ three instalments beginning in Elektor September/October 2020: 
www.elektormagazine.com/magazine/elektor-155/58969 
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Simple 


ketcnes 


Using the 
wiic Ecosystem 


By Marcus Stevenson (USA) 









The Qwiic system is a SparkFun innovation that utilizes the PC 
protocol and polarized 4-pin JST connectors to allow you to create 
modular circuits using any of our 100+ compatible breakout boards 
and microcontrollers. Not sure what that means? No worry! All you 
really need to know is that Qwiic eliminates the hassles of soldering 
hookup wire and deciphering messy hookup diagrams, making 
it extremely easy for even a novice to pick up an Arduino and any 
given sensor, and begin experimenting right away. Don't believe me? 
Check out the following simple sketches utilizing SparkFun’'s Qwiic 
Pro Micro and a handful of other breakout boards. 


umes that you ve already _ 
duino IDE and installed the necessary wae . 

pee out SparkFun.com for setup instruc 

C 

each product if you need help. 


This article ass 
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Color-Changing Rotary Encoder 


© Circuit: Figure 1; Program code: Weblink [1]. 


For this example, you'll need the Qwiic Pro Micro, the Qwiic Twist 
RGB Rotary Encoder, and the Qwiic Mirco OLED Breakout. As you'll 
see in subsequent examples, the wiring hookup is essentially the 
Same in each circuit. 


Simply use Qwiic cables to connect the Pro Micro to the rotary 
encoder and OLED display. The order that you put them in doesn't 
matter, as long as they're all connected together. Then, all you need 
to do is plug the Pro Micro into your computer, and upload the 
QwiicTwistMicroOLEDDisplay.ino sketch. Make sure that you select 
“ATMEGA 32U4 (5V, 16MHz)” under the “processor” option, or else 
you will get an upload error! If all is successful, you should see 
the SparkFun Flame logo appearing on the OLED display briefly, 





Figure 1: Board hookup for Color-Changing Rotary Encoder. 


Figure 3: “Do not try this at home”... 


then the display should show the name of the color that the rotary 
encoder is currently set to. When you turn the knob, the color of 
the knob should change, along with the name displayed on the 
OLED. Also, when you press the knob like a button, the screen 
should read, “Pressed!”. 


This sketch utilizes the getCount() function to determine the 
current count of the encoder and uses the setColor() function 
to change the color of the encoder’s RGB LED according to the 
count, alternating between red, green, violet, yellow, pink, blue, 
and orange. It also uses the OLED library's clear (), setCursor (), 
print(),anddisplay() methods to print the color names to the 
display. 


Qwiic Environmental Thermometer 


© Circuit: Figure 2; Program code: Weblink [2]. 


This example also utilizes the Qwiic Micro OLED Display and Pro 
Micro, but this time we'll swap the rotary encoder with the Qwiic 





g 


“2 (ND XY XL 


Figure 4: Board hookup for Capacitive Touch Input Made Easy. 


Environmental Combo Breakout. This sensor allows the user to 
collect all kinds of environmental data, including barometric 
pressure, humidity, temperature, TVOCs and equivalent CO, levels 
(eCO,). We won't be getting too fancy with this example though. 
All we're going to do is print the current temperature to the micro- 
OLED display, and in Fahrenheit, too. Base-ten units of measure- 
ment are so pretentious. Assuming you built the previous circuit, 
disconnect the rotary encoder, and connect the Environmental 
Combo Breakout with the Qwiic cable. 


Now you're ready to upload the QwiicEnvironmentalComboMicroO- 
LEDDisplay.ino sketch to the Pro Micro. Once you have, you should 
see the flame logo briefly, then the display should read, “Temp:” 
followed by the current temperature in degrees Fahrenheit. If 
you blow on the sensor, or lightly flame-torch over it (Figure 3), 
you should see the temperature fluctuate. This sketch uses the 
readTempF () function to display the temperature reading of the 
BME280 IC. If you were really feeling fancy, you could use the 
readTempC() method for, you guessed it, readings in degrees 
Celsius. 
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Figure 5: Board hookup for Qwiic Presence Detector. 


Capacitive Touch Input Made Easy 


@ Circuit: Figure 4; Program code: Weblink [3]. 


Buttons are so overrated. Their mechanical nature dooms them 
to failure eventually. Capacitive touch inputs allow you to interact 
with your projects sans moving parts. In this sketch, we'll continue 
using the Micro OLED display, and interact with it using the Qwiic 
capacitive touch slider. Simply disconnect the Environmental 
Combo breakout, and replace it with the Capacitive Touch Slider. 
This little breakout allows you to use the three pads as individ- 
ual inputs, or to detect swipe gestures across all three pads. Also, 
you can use the broken-out pins to solder on your own pads for 
custom applications. 


Once you're all wired up, upload the CapSliderMicroOledExample. 
ino sketch to the Pro Micro. Initially, you'll see the SparkFun Flame 
logo, then the display should go blank. When you touch any of 
the three pads on the breakout, you should see a corresponding 
vertical rectangle illuminated on the OLED display. SparkFun uses 
Capacitive touchpads on all of their production test beds because, 
unlike tactile switches, they never wear out and never need to be 
placed. Unlike tactile switches, you never get that satisfying ‘click’... 


Qwiic Presence Detector 


© Circuit: Figure 5; Program code: Weblink [4]. 


Need to know when an object is present, which was not before? 
Want to know if an object has moved past a certain point in space? 
This sketch can do both. Once again, we will keep the Micro OLED 
Display from our previous example, and swap the Capacitive Touch 
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Figure 6: Board hookup for Tactile Input, Audible Output. 


Slider for the SparkFun Proximity Sensor Breakout. This little sensor 
is ultra simple and equally useful, combining an Infrared Emitter, 
Ambient Light Sensor, and Proximity Sensor, for close-range object 
detection. 


When everything’s hooked up, upload the ProximityMicroOLE- 
Dexample.ino sketch to the Pro Micro. Again, you should see 
the SparkFun Flame logo briefly. During these examples, if the 
OLED display freezes on the flame logo, try tapping the reset 
button on the Pro Micro. If this doesn't fix the problem, it’s likely 
that there’s a problem with the Qwiic cables or connectors, so 
try unhooking and re-connecting your circuit. If everything 
is working properly, the screen should go blank, but become 
illuminated when you pass your hand or an object within about 
20 centimeters of the Proximity Sensor Breakout. These sensors 
are common in all kinds of touch-free appliances like automatic 
paper towel dispensers. 


Tactile Input, Audible Output 


© Circuit: Figure 6; Program code: Weblink [5]. 


There's more to Qwiic than just outputting data from encoders 
and sensors. The modularity of the system allows you to combine 
whichever features your project requires in a plug-and-play fashion. 
In this example, we'll lose the OLED display and sensors entirely. 
Using the Sparkfun Qwiic MP3 Trigger and the Qwiic Joystick, this 
sketch demonstrates how you can use Qwiic to easily create highly 
interactive objects. 


Similar to the previous examples, simply connect your MP3 Trigger 
and Joystick breakouts to the Pro Micro via a couple of Qwiic cables. 
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Figure 7: Board hookup for Red, Green, or Blue? 


This Circuit will also require a speaker or headphones for audio, so 
plug an audio output into the MP3 Trigger’s headphone jack. Also, 
you will need to copy four MP3 files named Foo1.mp3, Foo2.mp3, 
Foo3.mp3, and Foo4.mp3 to the root file of a micro SD card, and 
insert that SD card into the SD slot on the MP3 Trigger. With all this 
set up, you're ready to upload the joystickmp3example.ino sketch 
to the Pro Micro. 


If everything is connected properly, you should hear the MP3 files on 
the microSD card play through your headphones/speaker whenever 
you press the joystick up, down, left, or right. If you download the 
audio tracks from the SparkFun Simple Sketches GitHub Repos- 
itory, the audio will say, “up, down, left, right,” corresponding to 
the direction that the joystick is tilted. 


Red, Green, or Blue? 


© Circuit: Figure 7; Program code: Weblink [6]. 


With the number of possible combinations of Qwiic breakouts, it 
can be fun to grab a couple at random and try to make a gadget out 
of it. In this sketch, we'll reprise the Qwiic Twist RGB Rotary Encoder 
and introduce the SparkFun Qwiic Spectral Sensor Breakout. This 
sensor comes in a few varieties, but for this sketch, we'll be using 
the visible spectrum version of the sensors. The Spectral Sensor 
allows you to sense visible colors, and in this example, we'll use it to 
detect whether a transparent colored marble is red, green, or blue. 
Like all the previous examples, all you need to do is link together 
the Qwiic Twist Rotary Encoder and the Spectral Sensor Breakout 
via Qwiic cables, and connect them to the Pro Micro. You'll also 
need some red, green, and blue objects to test. I used marbles, but 
pretty much anything that you can fit over the sensor will work. 








© Related Products 


Looking for the main items mentioned in this article? 
SparkFun and Elektor have you covered! 


> SparkFun Qwiic Pro Micro - USB-C (ATmega32U4) 
www.elektormagazine.com/esfe-en-smallcircuits1 


> SparkFun Qwiic Twist - RGB Rotary Encoder Breakout 
www.elektormagazine.com/esfe-en-smallcircuits2 


> SparkFun Micro OLED Breakout (Quwiic) 
www.elektormagazine.com/esfe-en-smallcircuits3 


Upload the VisSpectrumTwistColorExample.ino to the Pro Micro. 
If everything is set up correctly, you should be able to test various 
objects to see if they are red, green, or blue by holding the object 
over the Spectral Sensor, and pressing the knob of the Qwiic Twist. 
Depending on the color detected by the sensor, the RGB LED of the 
rotary encoder should change correspondingly. If you test an object 
which is not any of the three colors, the result will be whichever 
wavelength (R, G, or B) returns the greatest value. M 

200696-01 
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[1] Color-Changing Rotary Encoder program code: 
https://bit.ly/2XHeLfv 

[2] Qwiic Environmental Thermometer program code: 
https://bit.ly/35BP5VJ 

[3] Capacitive Touch Input Made Easy program code: 
https://bit.ly/2XB5FAO 

[4] Qwiic Presence Detector program code: 
https://bit.ly/3qjqjBN 

[5] Tactile Input, Audible Output program code: 
https://bit.ly/3idt4BU 

[6] Red, Green, or Blue? program code: 
https://bit.ly/3ibXnJa 





lektor July & August 2021 69 


SOAS 





Java onthe 
Raspberry P1 


Part 2: Controlling GPIOs 
with a Spring REST Service 





By Frank Delporte (Belgium) 


Is Java a programming language suitable for 





the Raspberry Pi? In the previous article, this was 

answered with a resounding “yes”! With some single-file 

Java demo applications under our belts, itis now time to go a little deeper. Expanding on 
the material covered, we now move a few Steps further and construct a full application 
with multiple classes. These provide us with REST web services that control the GPIOs of 


a Raspberry Pi. 


The “Raspberry Pi OS Full (32-bit)” version of the operating system 
already includes the Java Development Kit (JDK) version 11. However, 
to develop Java applications, an IDE will help us write applications that 
are easy to maintain. As described in the previous article [1], Visual 
Studio Code can be used on the Raspberry Pi. Alternatively, applica- 
tions can be developed in Visual Studio Code on a PC, then compiled 
and run on the Raspberry Pi. 


For this article, we will write the code directly on the Raspberry Pi. For 
this we need some additional tools, so let's start by installing them. 


Maven 

We are going to use Maven to build the application on our Raspberry 
Pi. Maven compiles code, together with the required dependencies, 
into a single JAR file. This is possible thanks to the pom.xml configu- 
ration file that is found in the root of the project. 


Maven is installed with a single command, after which we can immedi- 
ately check the installation by requesting the version as follows: 


$ sudo apt install maven 
$ mvn -v 
Apache Maven 3.6.0 


Maven home: /usr/share/maven 
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Pi4J 

To control the GPIOs, we are going to use the Pi4J library that forms a 
bridge between our Java code and the general-purpose input/output 
(GPIO) pins on the Raspberry Pi. This allows us to control the GPIOs 
and connect to various electronic components. 


For full support of the Pi4J library on the Raspberry Pi, we need to install 
some extra software. Again, we only need a single command to do this: 


$ curl -sSL https://pi4j.com/install | sudo bash 


Update of WiringPi 

One last step is required to be fully prepared. If you are using a 
Raspberry Pi 4, you'll need to update WiringPi. This is used by Pi4J as 
a native library to control the GPIOs. Because the architecture of the 
system-on-chip (SoC) has changed with version 4, a new version of 
WiringPi is required. Unfortunately, this project got deprecated last 
year, but thanks to the open-source community an ‘unofficial’ version 
is available that can be installed by a script provided by Pi4J. Run the 
command: 


sudo pi4j -wiringpi 


| 
u m= 
REST | Aa 


Library a 





Native libraries 


w 
ai 
5 
E 
E 
A= 
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= 
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GPIO, 20, SPI, Serial, PWM 


Figure 1: Overview of the application using the Spring REST service and the Pi4J library. 


This acquires the project from GitHub, compiling and installing it on 
your Raspberry Pi all in one go. By requesting the version, you will see 
it's upgraded from the default 2.50 to 2.60: 


$ gpio -v 

gpio version: 2.50 

$ sudo pi4j -wiringpi 
$ pi4j -v 


PI4J.VERSION i Leo 
PI4J. TIMESTAMP >; 2021-01-28 04:14:07 
WIRINGPI.PATH : /usr/lib/libwiringPi.so /usr/local/lib/ 
LibwiringPi.so 

WIRINGPI.VERSION : 2.60 


The Application 

The full code of this application is available from the GitHub repos- 
itory that accompanies this article [2] in the folder elektor /2106. 
This project is a proof-of-concept application that controls the GPIOs 
using a REST web service. It uses the Spring framework, software that 
provides a lot of tools for building powerful applications with minimal 
code (Figure 1). In what follows, the process for creating the various files 
that make up this project is described. If it doesn’t work as described, 
the repository code should work out-of-the-box. 


The finished project is pulled from GitHub as follows: 


pi@raspberrypi:~ $ git clone https://github.com/FDelporte/ 
elektor 

Cloning into ’elektor’... 

Enumerating objects: 34, done. 

Counting objects: 100% (34/34), done. 

Compressing objects: 100% (24/24), done. 

remote: Total 34 (delta 2), reused 34 (delta 2), pack-reused 0 

Unpacking objects: 100% (34/34), done. 

pi@raspberrypi:~ $ cd elektor/2106 

pi@raspberrypi:~/elektor/2106 $ ls -l 

total 8 

-rw-r--r-- 1 pi pi 1720 Feb 15 14:23 pom.xml 

drwxr-xr-x 3 pi pi 4096 Feb 15 14:23 src 


remote: 
remote: 
remote: 





A initializr 


Project Language 


(®) ; 


Dependencies ADD DEPENDENCIES... 3 + B 


(©) (®) Spring Web 


Spring Boot 
re) : 
©) 


Project Metadata 


EXPLORE CTRL + SPACE 


GENERATE 3 + 


Figure 2: Configuration settings required for Spring Initializr. 


What Is Spring and Its Tools? 

Spring is a framework that simplifies and speeds-up the develop- 
ment of (business) Java applications. Spring Boot is a layer that sits 
on top of Spring providing ‘off-the-shelf’ packages. These allow us to 
create stand-alone Spring-based applications that you can ‘just run: 
This is achieved by a principle known as ‘convention above configu- 
ration: What this means is, by default, everything operates according 
to predefined convention. If you need to do something different, you 
can then configurate your way. 


The most important capabilities, as listed on the Spring Boot website 
[3], are: 


> Easy creation of stand-alone Spring applications. 

> Allows a web server to be embedded inside your application 
(Tomcat, Jetty or Undertow), 

> Provides ‘starter’ dependencies to simplify your build 
configuration. 

> Automatically configures Spring and 3rd party libraries whenever 
possible. 

> Offers production-ready features such as metrics, health checks, 
and externalized configuration. 

> Absolutely no need for code generation or XML configuration. 
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o Gay ma (oj [localhost - Chromium] X] JavaspringrestgpioA.. 





JavaspringrestgpioApplication.java - javaspringrestgpio - Visual Studio Code 
File Edit Selection View Go Run Terminal Help 





Figure 3: Executing project in Visual Code Studio. 


Finally, there is Spring Initializr [4], an online tool to quickly create an 
starter application that includes all the Spring Boot packages required. 


Getting Started 

To create this project from scratch, we start by using Spring Initializr, 
a web-based configuration form, to create a getting-started package 
for us. Follow the link in [4] and then copy the options into the form 
using information in the screenshot shown in Figure 2. On the right- 
hand side, make sure also to click the “Dependencies” button. In the 
window that opens we need to add the “Spring Web” dependency. 


Listing 1: Output of a Starter Application. 


o oo 000000000 00000000000 
e 


Nt cee tr, ee ee (ee ane 


(Gp eam Ween eter eyes ee 
Ge eee] A) te i ie tle lltlim eae llfeene es) 6)e a) 
Bee Neen geese |e Teall Gallet S ll cae age 
sen | se =seeeceesse [fey 


eS Prime BOOE cee Seo any 2 4.22) 


Starting JavaSpringRestAppLlication 


No active profile set, falling back to default profiles: default 


Tomcat initialized with port(s): 8080 (http) 
Starting service [Tomcat] 
Starting Servlet engine: [Apache Tomcat/9.0.41] 


Initializing Spring embedded WebApplicationContext 


Root WebAppLlicationContext: initialization completed in 1607 ms 


Initializing ExecutorService ’applicationTaskExecutor’ 
Tomcat started om port(s): 8080 (http) with context path °?’ 


Started JavaSpringRestApplication in 4.582 seconds (JVM running for 7.196) 


Initializing Spring DispatcherServlet ’dispatcherServlet’ 
Initializing Servlet ’dispatcherServlet’ 
Completed initialization in 9 ms 
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This can be found quickly using the search box. 
Clicking on this entry adds it to the project. 
Should an unwanted dependency be added 
by mistake, simply click on the red button (far 
right) to remove it. 


$ TL 1237 


The addition of the “Spring Web” dependency 
allows us to build a REST-application [5] that 
enables us to connect to the application via 
webpages in our browser. 


Clicking on the “Generate” button delivers a 
Z\P-file with a ready-to-use Maven project. 
Once It has been unzipped into a suitable direc- 
tory, it can be opened in Visual Studio Code [6]. 
This works, at this point, both on the Raspberry 
Pi or on a PC. Simply use File -> Open folder... 
and select the unzipped folder. Next, find the 
file JavaSpringRestApplication.java (under src/ 
main/java). Via a right-click on this file name, 
the option Run is available. Select Run and the 
application should start (Figure 3). If your Visual 
Studio Code install doesn't already have the 
required Java support, a pop-up window will 
appear to request Its installation. 


In the Terminal panel we obtain the output in Listing 1 (here with 
timestamps removed). So, what does this output tell us? 


> The JVM (Java Virtual Machine) has run for 7 seconds, 4.5 
seconds of which were needed to start the application. 

> Tomcat (the webserver) is embedded in the application and 
running on port 8080. 


Nice, so let's open a browser and go to http: //localhost: 8080/ 
(Figure 4), 


We get an error page — a little disappointing. 
This is because we haven't created anything 
yet to be shown on this page! However, at the 
same time, this error page proves that our appli- 
cation is working and functions as a web server. 
It just doesn't know yet what to share with us. 


Building Our Own Application 

We will now extend this Spring starter package 
to include the functionality we want in our appli- 
cation, namely control of the GPIOs using Java 
code. To be able to do this, we must include 
the Pi4J library in our project. Thanks to this 
library we don't need to control the hardware 
ourselves as we can use the full set of Java 
methods that are provided by Pi4J. However, 
we need to remember that, because of the 
dependency of this library on the Raspberry 
Pi, we can not run or test this application fully 
on the PC. The JAR file produced will need 
to be executed on the Raspberry Pi to test its 
control of the GPIOs. 


Within the code examples that are provided here, each variable and 
method is documented in the JavaDoc style (starting with /*x) to 


explain their purpose. 


Adding the Dependencies 


Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 


Fri Jan 22 12:27:53 CET 2021 
There was an unexpected error (type=Not Found, status=404). 


With the project created with Spring Initializr open, we add the 
pi4j-core dependency to the pom.xml file. This ensures we can 


access the pi4j methods: 


<dependency> 
<groupId>com.pi4j</groupiId> 
<artifactId>pi4j-core</artifactId> 
<version>1.3</version> 
<scope>comp7 lLe</scope> 
</dependency> 


While we are here, we can also add the OpenAPI 
dependency (springdoc-openapi-u7) that we use 
later to test the REST services: 


<dependency> 

<groupId>org.springdoc</groupId> 
<artifactId>springdoc-openapi-ui</artifactId> 
<version>1.5.1</version> 

</dependency> 


Adding an Information REST 
Controller 

The first thing we are going to expose with this 
application is the information provided by the Pi4J 
library about our Raspberry Pi. We start by creating 
a package “controller” with a file InfoRestController. 
Java. In Visual Studio Code, simply right-click the java\ 
be\webtechie\javaspringrestgpio entry and select 
New Folder. Name the new folder “controller” Then 
right-click the folder controller and select New File. 
Name the file /nfoRestControllerjava. 


In the sources you can find the full code, but Listing 2 
provides a short snippet of its contents. Each method 
is a REST mapping that returns a specific set of 
key-value pairs with information about the Raspberry 
Pi, 


Adding the GPIO Manager 

Before we can create the GPIO REST controller, we 
must add a GpioManagerava file to handle the Pi4J 
calls. This is placed in a "manager" package (created 
as a New Folder and New File as before). We will use 
this manager to store the initialized GPIO pins and call 
the Pi4J methods to interact with the GPIOs. Again, 
a short section of the code is provided in Listing 3, 
while the full code for this class is in the sources in 
the repository. Note that we use @Service in this 
class that instructs the Spring Framework to keep a 
single instance of this object in memory. This ensures 
we maintain a map of the provisioned GPIOs avail- 
able at all times. 


Figure 4: The default error webpage proves the web server is operational. 


Listing 2: Section of the InfoRestController.java file. 

[xx 

x Provides a REST-interface to expose all board info. 

* / 
@RestController 
@RequestMapping (“info”) 

public class InfoRestController { 

private Logger logger = LoggerFactory.getLogger(this.getClass() ) ; 


[xx 
x Get the OS info. 
* / 
@GetMapping(path = “os”, produces = “application/json”) 
public Map<String, String> getOsInfo() { 
Map<String, String> map = new TreeMap<>(); 
try 2 
map.put(“Name”, SystemInfo.getOsName() ) ; 
} catch (Exception ex) { 
logger.error(“OS name not available, error: {}”, 
ex.getMessage()); 
i 
thy i 
map.put(“Version”, SystemInfo.getOsVersion()) 5 
} catch (Exception ex) { 
logger.error(“OS version not available, error: {}”, 
ex.getMessage()); 
t 


return map; 


[xx 
x Get the Java info. 
x / 
@GetMapping(path = “java”, produces = “application/json”) 
public Map<String, String> getJavaInfo() { 
Map<String, String> map = new TreeMap<>(); 
map.put(“Vendor “, SystemInfo.getJavaVendor()); 
map.put(“VendorURL”, SystemInfo.getJavaVendorUrl()) 5 
map.put(“Version”, SystemInfo.getJavaVersion() ) ; 
map.put(“VM”, SystemInfo.getJavaVirtualMachine()); 
map.put(“Runtime”, SystemInfo.getJavaRuntime() ) ; 


return map; 
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Listing 3: Section of the GpioManager.java file. 
VEK 
x Service instance managing the {@link GpioFactory}. 
x/ 
@Service 
public class GpioManager { 
private Logger logger = LoggerFactory.getLogger(this.getClass()); 


[xx 
x The GPIO controller. 
x / 


private final GpioController gpio; 


[xx 
x List of the provisioned pins with the address as key. 
* / 
private final Map<Integer, Object> provisionedPins = 
new HashMap<>() ; 


[*x 
x Constructor which initializes the Pi4J {@link GpioController}. 
* / 
public GpioManager() { 
String osName = SystemInfo.getOsName() ; 
if (osName.toLowerCase().contains(“raspberry”) || osName.toLowerCase().contains(“lLinux”)) { 
this.gpio = GpioFactory.getInstance() ; 
} else { 
logger.error(“GPIO could not be initialized. Not running on Raspberry Pi but ’{}’”, osName) ; 
this.gpio = null; 


x Get the pin for the given address. 


x @param address The address of the GPIO pin. 
x @return The {@link Pin} or null when not found. 
x / 
private Pin getPinByAddress(int address) { 
Pin pin = RaspiPin.getPinByAddress (address); 
if (pin == null) { 
logger.error(“No pin available for address {}”, address); 


} 


return pin; 


[xx 


x Provision a GPIO as digital output pin. 


* 


x @param address The address of the GPIO pin. 


Adding the GPIO REST controller webpage to test the REST services. Swagger is another open-source 
Finally we add a GPIO controller with a REST interface to the control- project that generates a simple webpage interface to test our Java 
ler package (folder). This file is named GpioRestController.java. This code by automatically visualizing the controllers we created. 
exposes the Pi4J GPIO methods we defined in the GpioManager.java 

class. Again, a section of the code is shown in Listing 4 and the full | There are two ways to start the application. In Visual Studio Code it 


code is available from the repository. can be started using Run (Raspberry Pi or PC). The alternative is to 
build the application to a jar file with mvn package (Raspberry Pi only). 
Running the Application Once built, it is run as follows from the command line: 


This step can be undertaken on both the PC or the Raspberry Pi. If 
running on the PC, it is best to run the application from within Visual java -jar target/javaspringrestgpio-0.0.1-SNAPSHOT. jar 
Studio Code. This avoids having to install Maven on the PC. 

In a browser on the Raspberry Pi, open the Swagger page using 
Because we added the springdoc-openapi-ui dependency inthe pom. = http://localhost:8080/swagger-ui.html. Alternatively, using 
xml file, the application will provide us with a very useful Swagger any PC on the same network, use http: //<IP_ADDRESS_RASPBERRY_ 
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x @param name The name of the GPIO pin. 
* @return True if successful. 
* / 
public boolean provisionDigitalOutputPin(final int address, 
final String name) { 
if (this.provisionedPins.containsKey(address)) {f{ 
throw new ILlegalArgumentException(“There is already” 


+ “ a provisioned pin at the given address”) ; 


final GpioPinDigitalOutput provisionedPin = this.gpio 
.provisionDigitalOutputPin( 
this.getPinByAddress(address) , name, PinState.HIGH) ; 
provisionedPin.setShutdownOptions(true, PinState. LOW) ; 


this.provisionedPins.put(address, provisionedPin) ; 


Kerturnt erue; 


[xx 

x Toggle a pin. 

* 

x @param address The address of the GPIO pin. 

* @return True if successful. 

x / 

public boolean togglePin(final int address) { 

logger.info(“Toggle pin requested for address {}”, address); 


Object provisionedPin = this.provisionedPins.get(address) 5 


if (provisionedPin == null) { 
throw new ILlegalArgumentException(“There is no pin” 
+ “ provisioned at the given address”); 
} else { 
if (provisionedPin instanceof GpioPinDigitalOutput) { 
((GpioPinDigitalOutput) provisionedPin).toggle() ; 


return true; 
} else { 
throw new ILlegalArgumentException(“The provisioned pin” 
+ “ at the given address is not of the type” 
+ “ GploPinDagitaloutpun” ): 





gpio-rest-controller pio Rest Controller info-rest-controller Info Rest Controller 
/gpio/digital/pulse/{address}/{duration} pulsePin a /info/codec getCodecinfo 


ia wera /info/frequencies getClockinfo 
| cr | /info/hardware getHardwareinfo 
ore Jinfo/java getievainfo 

| car | /info/memory getMemoryinfo 


/gpio/provision/digital/output/{address}/{name} provisionDigitalOutputPin 
| cer | /info/network getSysteminfo 
jo/provision/list getProvisionList 
Lc | iid á i i | cer | /info/os getOsinfo 
EI levteystatestaadress) ses B ioro sra 


/gpio/digital/state/{address}/{value} setPinDigitalState 
/gpio/digital/toggle/{address} togglePin 


/gpio/provision/digital/input/{address}/{name} provisionDigitallnputPin 














Figure 5: The Swagger page provides access to the info and GPIO REST controller APIs. 


-O 
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Listing 4: Section of the GpioRestController.java file. 


IER 


a 





Ca 
Tae 


Co 


p 





private Logger logger = 


x Provides a REST-interface to interact with the GPIOs. 


@RestController 
@RequestMapping(“gpio”) 
public class GpioRestController { 


LoggerFactory.getLogger(this.getClass()); 


[xx 


x Reference to the GPIO manager service 


* / 


private final GpioManager gpioManager ; 


[*x 


x Constructor used by Spring to “inject” the GPIO manager 
x into this class. 

x 

x @param gpioManager {@link GpioManager} 

x / 


public GpioRestController(GpioManager gpioManager) { 


PI>:8080/swagger-ui.html. The two controllers with 


this.gpioManager = gpioManager; 


their methods will be displayed as in Figure 5. ; 
Testing the Information REST 
Controller E 


We can click on the Swagger page buttons and execute 
the available options. For example, in the section 
info-rest-controller we can click on GET next to the 
info/hardware method. This is followed by clicking Try 


P O + ee 


— C Q f 192.168.0.223:8080/info/hardware 


JSON Onbewerkte gegevens 





Headers 


Opslaan Kopiëren Alles samenvouwen Alles uitvouwen Y JSON filteren 


BoardType: "RaspberryPi_3B_Plus" 
CpuArchitecture: "7" 
Cpucorevoltage: ga ig 


CpuModelName: "ARMY? Processor rev 4 (v71)" 





CpuPart: "exde3" 

CpuRevision: "g" 

CpuTemperature: "49.9" 

Hardware: "BCM2835" 

HardwareRevision: "a020d3" 

IsHardFloatABI: "rue" 

Processor: zg 

SerialNumber: "@800800022278C6b" 
ewww ewww wewe vvv vv vvv vvv vvv we wee we ew s 
eeeoeoevoeveeeeeeeeeeee eeeoeoeeeveeeees 
eeeeoeoeeveeeeeeeeeeee eeeeoeeeeeeees 
eeeeoevoeveveeveeveeeeeeee eeeeoeeeeeeees 
eeeeoeoeeeeeee eee eeeteoeeeeeees 
eeeeoeeoeeeeee eee eeeteeoeeeeeees 
eeeoeoeeeeeee eee eeeteoeeeeeees 
eeeoeoeoveeeveee eee e.. ooo e 
e.. .ooooooooo o eee eeeececees 





Figure 7: Wiring diagram to connect the switch and LED to the Raspberry Pi. 
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x Provision a GPIO as digital output pin. 
x 

x @param address The address of the GPIO 
x @param name The name of the GPIO pin. 


pin. 





JSON 


Raw Data Headers 


Save Copy Collapse All Expand All ‘Yy Filter JSON 


Runtime: "OpenJDK Runtime Environment" 
VM: "OpenJDK Server VM" 

Vendor : “Raspbian" 

VendoruURL: "Unknown" 

Version: aee A A E a 


Figure 6: The JSON data can be acquired directly by appending 
the method name to the URL. 


it out and then Execute that displays the response in the Response 
body section. 


All these methods can also be called directly from within the browser. 
Simply append the method name to the URL. For info/hardware we 
simply enter http: // localhost: 8080/info/hardware, and for info/ 
java itis http: // localhost: 8080/info/java. The data from calling 
these methods is displayed in JSON format as shown in Figure 6. 


Testing the GPIO REST controller with an LED and 
button 

To demonstrate how to interact with GPIOs using this application, we 
will be using a very simple breadboard setup (Figure 7) as follows: 





> LED on GPIO pin 15, BCM 22, WiringPi no. 3 
> Button on GPIO pin 18, BCM 24, WiringPi no. 5 


To be able to control the connected LED and read 
out the button state, we first need to Initialize the 
GPIOs. To configure the output, the method 

| | ) it Is used. Returning to 
the ) gger-u 
page, click GET by this method, Try it out and then 
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/gpio/provision/digital/output/ {address} /{name} provisionDigitalOutputPin /gpio/provision/digital/input/{address}/{name} provisionDigitalinputPin 
Name Description Name Description 
address * "aired address address * """"e address 
integer ($int32) 3 integer ($int32) 5 
(path) (path) 
name * "aired name name * ‘aire name 
string LED string Button 
(path) (path) 








Figure 8: Initialization of the GP/Os using the /gpio/provision/digital/ methods. 


enter 3 in address and LED in string. Commit the configuration by 


BR 1 22.150.0225.2000/spic/provision x clicking Execute (Figure 8 left). 


€ C ù & 192.168.0.223:8080/gpio/provision/list 





To configure the input, the method /gpio/provision/digital/ 
input is used. Click GET by this method, Try it out and then enter 5 


JSON Onbewerkte gegevens Headers 


Opslaan Kopiëren Alles samenvouwen Alles uitvouwen Y JSON filteren i ; 2 , ; , , 
R, in address and Button in string. Commit the configuration by clicking 

address: "3" Execute (Figure 8 right). 

mode: "output" 

name: "LED" 

pinName: "GPIO 3" Once the GPIOs are initialized we can get a list of them using the 

aai ees E ee /gpio/provision/list method. Simply use GET, Try it out, and 
v ProvisionedPin 5: Execute or type the URL http: //localhost:8080/gpio/provision/ 

ie ee List directly into the browser (Figure 9). 

mode: input 

name: "Button" 

= — = Now that we've checked the GPIOs are ready to use, we can toggle 


type: “com.pi4j.io.gpio. imp].GpioPinimp1" the LED on and off using the /gpio/digital/toggle method by 
repeatedly clicking on the Execute button (Figure 10). 


a E E E cont aus on wae There is also an additional method that can turn the LED on for a given 
/gpio/provision/list method, time, such as 2 seconds (Figure 11). Note that the duration must be 
provided in milliseconds. 




















/gpio/digital/pulse/f{address}/{duration} pulsePin 
POST i igi togglePi 
| post | /gpio/digital/toggle/{address} togglePin ERN 
Name Description 
Name Description address * "wie address 
integer ($int64) 3 
address * "1"? address (path) 
integer ($int64) 3 duration * "="? duration 
(path) 
integer ($int64) 2000 
(path) 





Figure 10: Using the Execute button in the Swagger interface to toggle the Figure 11: The LED can also be pulsed for a specified duration. 
LED, 
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Requesting the state of the button can be done via the Swagger inter- 
face, but also available directly via the URL http: //localhost: 8080/ 
gpio/state/5. In the case of Figure 12 the button is pressed, return- 
ing a 1. 


Time to REST, then explore further 

This application only exposes a few of the Pi4J methods as REST 
services to show the possibilities and power of this approach. Depend- 
ing on the project you want to build, you can extend or rework this 
example to fit your precise needs. 


The Pi4J library is currently being rewritten to provide even better 
support for the Raspberry Pi 4 and future versions. This will also bring 
it fully up-to-date with the latest versions of Java. In the meantime, the 
current version allows you to get started and build applications where 
you want to integrate hardware control through a REST API. I< 
200617-B-01 
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Figure 12: The URL together with the gpio/state/5 method acquires the 
state of the Button input. 


Questions or Comments? 

Do you have questions or comments regarding this article? 
Then contact the author directly via 
Javaonraspberrypi@webtechie.be or the editor via 
editor@elektor.com. 
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FEATURE 











Raspberry Pi 
Compute 
Module 





A Raspberry PI for Industry 


By Mathias ClaußBen (Elektor) 


The Raspberry Pi Compute Module 4 has 
arrived. It has a new form factor and new 
peripherals, but will it make a good compute 
module, too? In combination with the 
Rasbperry Pi Compute Module IO Board, this 
forms new possibilities to create Raspberry 
Pi-powered systems that were not possible 
with older modules. With the added PCI 
Express interface, you can now choose from 
high-speed peripherals to be combined 

with the Raspoberry Pi. 


Rumors have been around for a while, and now we have the official 
proof of a Raspberry Pi 4-based compute module — Raspberry Pi 
Compute Module 4 (CM4). The Compute Module is a stripped-down 
Raspberry Pi-based module intended to be incorporated Into other 
products that need more design flexibility than the usual Raspberry 
Pi can offer. Also, it enables you to tightly integrate custom electro- 
nics around the Raspberry Pi SOC (e.g. for industrial usage or digital 
signage). The compute modules that have the SoCs found on Raspberry 
Pi Zero and Raspberry Pi 3B(+) have been released in an SO-DIMM 
form factor, installing like RAM into your PC. While this offered great 
flexibility, it also had some drawbacks, as the Ethernet Phy and USB 
hub controller was not incorporated into the module. This meant you 
had to add this on your own. Also, Wi-Fi was not an option. It had to be 
installed on your own base board and added to your BOM cost. This 
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Figure 1: The top of the Raspberry Pi Compute Module 4. 


made the Compute Module 3 and Compute Module 1 not applicable 
for some application. And the lack of a kind of high-speed interface, 
as both modules had only one USB2.0 port, was not helpful for adding 
high bandwidth or low-latency peripherals. Given the Compute Module 
1 and Compute Module 3 prices, you could use an ordinary Raspberry 
Pi for some projects, as everything you needed was already installed 
in a well-known form factor. The Compute Module 4 changes things 
dramatically because a lot of thought has gone into making it better 
than previous versions. 


First look at the PCB 

Figure 1 and Figure 2 will give you a first impression of the PCB. 
The Compute Module 4 comes now in 32 varieties. You can select 
wireless or no wireless, onboard EMMC with 8, 16 or 32 GB or no 


onboard EMMC and 1, 2 ,4 and 8 GB of RAM. This means you can 
select the version that's just right for you. Refer to the Specifications 
text box for the specs, which are the same as those for the Raspberry 
Pi 4. Figure 3 shows the component sections found in a Compute 
Module 4 with wireless and without EMMC installed. On the left is 
the PMIC responsible for all the power rails that are needed by the 
Compute Module 4 to operate (Figure 4). Located next to it is the 
wireless module supporting Wi-Fi with 5 GHz and 2.4 GHz and also 
offering Bluetooth connectivity. In the center (Figure 5), you find the 
BCM2711, the SoC that is the heart of the Compute Module 4 and offers 
four Cortex-A72 cores. At the top right (Figure 6), a BCM54210PE 
will provide 1000Base-T Ethernet support, including IEEE1588-2008 
support for precision timing. This means all you need to do for your 
one base board to get Ethernet support Is just attaching a MagJack, 
and for good practice, also add some ESD protection. On the right 
side (Figure 7), we have a RAM module and on top a small flash chip 
with basic boot information on it. 


On the bottom (Figure 2), you can see capacitors and oscillators as requi- 
red support for the SoC. You can also see two 100-pin Hirose connectors 
used to attach the Compute Module 4 to a baseboard. This is a change 
from the former Compute Module. One side of the connector has all 
the power and low-speed signals attached to it; the other one carries 
all the high-speed signals, making routing less of a hassle. For power 
we only need to supply 5 V to the module; the onboard DC/DC conver- 
ter will generate all the voltages required for the Compute Module 4. 


Refer again to the Specifications text box. The USB 3.0 interface on 
the Raspberry Pi 4B is not listed, and there is a good reason for that. 
With the Raspberry Pi 4B, there was a USB 3.0 controller attached 
to the BCM2711 via a PCI Express 2.0 single lane connection. This 
circuitry is not included on the Compute Module 4 and exposes the 
PCI Express lane for our own use. This creates new possibilities to 
utilize a Raspberry Pi where the former ones could not work. In the 
next section, l'Il explain how to get started with the module and how 
to develop your own creations. 


A 
P 44 ~~ a — ~ 


Raspberry. 


Figure 4: PMIC. 
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Figure 2: The bottom of the Raspberry Pi Compute Module 4. 





Figure 3: The Raspberry Pi Compute Module 4’s component sections. 





Figure 6: Phy, 
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Figure 9: CSI Ports. Figure 10: DSI Ports. 


To get started with the Raspberry Pi 4 Compute Module, the Raspberry 
Pi Foundation also created an I/O Board (Figure 8) that exposes 
all the nice features of the Compute Module and also Includes PCI 
Express 1x slot with it. The board offers more connectivity than you 
get with the other Raspberry Pi 4 products, two camera inputs (CSI-2 
interface with two or four channels, shown in Figure 9). Two display 
connectors (DSI with two or four channels, shown in Figure 10) 
enable multiple monitors and vision-processing capabilities. Want to 
attach a mouse and keyboard? The internal USB 2.0 port of the CM4 
has been added with an USB 2.0 Hub on the I/O Board providing 
up to four USB 2.0 ports (Figure 11). The I/O Board also includes an 
RTC Module that can be used as a watchdog or to boot the system 
in given intervals. 


For the power input, all you need on the board is a 12 V supply (if you 
are using PCI Express cards). If you are not using the PCI Express slot, 
input voltage can be up to 26 V. Something that has changed and is 
welcome are the two regular size HDMI ports that can be found on 
the I/O Board to use the common HDMI cables (Figure 12). Finally, 
you get a LAN port and also a nice microSD Card slot. What makes 
the I/O Board interesting are the KiCad project files that are publicly 
released and allow for a fast start if you are using KiCad. The Compute 
Module 4 is added here as component and can be easy added to your 
own boards and design without fiddling to create a component in 
KiCad (Figure 13). Only a 3D model is not included. 
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Figure 11; USB Ports. 
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Figure 13: Screenshot KiCad component. 





Put parts together 

If you plan to develop with the Raspberry Pi Compute Module 4, the 
I/O Board is a desirable companion as it exposes all interfaces in a 
nice usable manner and gives also access for PCI Express devices. 
Getting started is as easy as with an ordinary Raspberry Pi 4: write 
an image to a SD Card and boot it up. If a mouse and keyboard are 
connected to the USB ports, they will not show up or work as used on 
the Raspberry Pi 4. If you want to use the USB ports with peripherals, 
you need to add a line inside the config.txt, which can found inside the 
BOOT partition of the SD Card. Add dtover Lay=dwc2 ,dr_mode=host 
at the end of config.txt, to get next time you boot the USB ports enabled. 
With the mounted PCI Express 1x slot adding cards that are 1x slot 
(one PCI Express lane) compatible is not a problem, but you have to 
keep in mind that those cards are powered from the 12 V input, so 
ensure enough power can be supplied. PCI Express has a nice part 
in the spec that allows cards that are designed for slots with 4x, 8x or 
16x configuration to also work with less lanes — meaning, they should 
work In 1x slots. Due to mechanical constrains, we cannot plug such 
a card directly into the Raspberry Pi I/O Board. 


Thankfully, during the increase in GPU-based crypto mining, this 
problem has also arisen on modern PC systems and solutions were 
developed. A suitable adapter board with its own power supply can 


be purchased for less than 10 bucks (Figure 14) and attached to the 
I/O Board. After the Raspberry Pi Compute Module 4 is booted and 
Linux runs, with Lspci a short look on the detected PCI Express cards 
is possible. As you can see in Figure 15, an Intel dual port network 
card is attached. This one is known to have a working Linux driver in 
mainline and should add additional network ports to the Raspberry Pi 
Compute Module 4. The output of lspci looks promising, the card is 
recognized, but there is no driver loaded. The reason for that is quite 
simple: the stock Kernel that ships with the Raspberry Pi OS has only 
drivers built in that are required for the day-to-day usage. 


Raspberry Pi Compute Module 4 (CM4) 
www.elektor.comraspberry-pi-compute-module-4-cm4 


Raspberry Pi Compute Module 4 IO Board 
www.elektor.de/raspberry-pi-compute-module-4-io-board 


Raspberry Pi Compute Module 4 Antenna Kit 
www.elektor.de/raspberry-pi-compute-module-4-antenna-kit 
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Are you wondering if connecting a GPU 
would work with this method? Connection 
is possible, but it will not work as you can see 
in this video [1]. For an Ethernet controller and 
other PCI Express devices like SATA cards, 
to get them to work you need to recompile 
the Kernel for the Raspberry Pi 4 [2]. As this 
is a software issue, it can be solved; but it 
is out of scope at this time to build a new 
kernel for the basic driver. Software, kernel 
builds, and driver are a separate topic that 
will be addressed in the future. Also, some 
PCI Express devices do not play at all with 
the Raspberry Pi Compute Module 4 as the 
driver assumes something that only can be 
found in X86/AMD64 world, like is currently 
the case with the GPU driver. 


Start innovating 

The Compute Module now comes in a new 
form factor and makes a first board design 
easy. Provided with KiCad symbols and 
schematics for the I/O Board, it simplifies 
product development. Why not fit a Raspberry 
Pi Compute Module 4 inside a set top box or 
home-built handheld? With the exposed PCI 
Express lane, we can add quad port Ethernet 
cards to provide in sum five ports at gigabit 
speed. That sounds like the ingredients for a 
Raspberry Pi Compute Module 4-based router. 





Figure 14: PCI Express adapter board. 


Given the price point for the Raspberry Pi 
Compute Module 4 and the I/O Board, starting 
is not too expensive, as the components are 
reasonably priced. If you want to build around 
the Raspberry Pi, it is easier than ever with 
the current generation of Compute Modules. 





(200590-01) 
Contributors 
Author: Mathias Clau8en 
Editor: Jens Nickel 
Figure 15: Components put together, Layout: Jack Jamar | GraphicDesign 


Questions and Comments? 


Do you have questions or comments 
[1] GPU ona Raspberry Pi: www.youtube.com/watch?v=ikpgZu6kLKE about this article? Email the author at 


[2] Quad port NIC on Raspberry Pi 4: www.youtube.com/watch?v=KL0d68j3aJM mathias.claussen@elektor.com. 
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Portable, Stand-Alone 
Air Quality Display 


for 2.5 um Particles 
Keep(s) an Eye on Your Health 


By Laurent Labbe (France) 







At this time of the COVID-19 pandemic, you would almost forget that there are other reasons 
to wear a face mask. And that there are places where this has been advisable, if not necessary, 
for much longer. Living in Asia in large cities, outdoor sports are often problematic due to 
air pollution, especially for 2.5 um particles, also called PM2.5. High concentrations of these 
small particles in ambient air can be harmful and even dangerous to your health. The PM2.5 
display presented in this article can be used to monitor air quality. 


| had already made a PM2.5 display, recharge- 
able with a solar panel but that was not 
suitable for indoor use. | had also designed 
an ESP32-based version, where | tested differ- 
ent sensors whose data was sent via WIFI 
to Thingspeak, but this was not portable. 
The main idea of this project is to design a 
device that is as compact as possible, battery 
powered, with an autonomy of several weeks 
and can permanently display the PM2.5 index 
of the ambient air. This portable display can 
be positioned outdoors, for example, with a 
suction cup stuck on a window so the PM2.5 
level is permanently visible from inside. But of 
course, you can also use It indoors. 


Design considerations 
The choice of the dust particle sensor is very 
important. In a previous project, | had tested 


several types of sensors, like an outdoor 
version with the Sharp GP2Y10 sensor. 
However, if we want a compact design, from 
all these sensors only the Plantower PMS7003 
sensor [10] is usable. It has a serial interface 
for sending measurement data. When you 
order this sensor, make sure that you buy it 
including the matching connector! As the 
sensor needs up to 100 mA at 5 V (mainly 
due to its internal mini fan), it cannot operate 
continuously, batteries will be drained in no 
time. The supply voltage is provided by a 
lithium battery, therefore a DC/DC converter 
(3.8 V to 5 V) with a true shutdown Is required. 


The display | selected is an 8 x 2-line 
monochrome alphanumeric LCD. It consumes 
less than 1 mA with permanent display. A 
colour or OLED display cannot be used due to 


their high-power consumption, which would 
seriously affect the autonomy of the project. 
For a quick view of the PM2.5 measurement, 
an LED bar graph is added. The level is repre- 
sented by a lit LED, six ranges of PM2.5 levels 
with five LEDs according to the colors shown 
in Table 1 with the highest level signaled with 
both the red and blue LED lit (maroon in the 
table), All LEDs are low power, e.g. Kingbright 
WP71xx series which have a forward current 
of 2 mA. A low power and high brightness 
version can be useful if the equipment is 
placed outside. 


Temperature and humidity display are also 
added (optional), using an 12C SHT20/SHT21 
sensor. The software also supports the DS1820 
1-Wire temperature sensor, but this has not 
been tested in this application. 


O 
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Air Quality Index Levels of Health Colors 
(AQI Values) Concern 






201 to 300 very Unhealthy Purple 


Table 1: AQI levels explained. 


The heart of the setup is a PIC18F2520, with 
a MAX931 for battery voltage monitoring 
and an LTC4054 lithium battery charger as 
peripherals. 


The overall power consumption of the 
detector depends mainly on the interval 
between the measurements. According 
to the PMS7003 specification, it must be 
powered on for 30 seconds before the first 
rellable measurement can be performed. By 
default, the interval is set to 20 minutes, but 
it can be changed via the menu. With this 
default setting and a 1000 mAh battery, this 
detector can run two weeks without recharg- 
ing. The size of the battery depends on the 
enclosure. Any lithium, LiPo or prismatic 
battery can be used. For this project, having 
developed a compact case, the battery will 
be as big as possible (in terms of volume) 
in the remaining space. | found an 1100 mAh 
battery that just fits. 


Features of the PM2.5 display 
Measurement of the 2.5 um particle level is 
made at regular intervals. This period can be 
changed in the menu between 10 minutes 
and 60 minutes, with 20 minutes being a 
good compromise between measurement 
accuracy and power consumption. Every 
hour, the program calculates the average of 
the last measurements, only one average Is 
kept and stored in a table. There are several 
ways to calculate the air quality level (associ- 
ated with PM2.5). In this project, two methods 
are available:|QA: arithmetic mean running 
over 24 hours 
> New AQI version: 12-hour moving 
weighted average (here called NQI). The 
most recent measurement has a greater 
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weight than the one made 11 hours ago. 
By default, the NQI version is displayed. 


The particle measurement level on the LED 
bar can show: 

> Most recent measurement (Last) 

> Last hourly average (Hour) 

> IQA or NQI 

The LEDs can be switched off during the 
night to save batteries. An LDR measures 
the ambient brightness and changes mode 
(day/night). 


An interesting option to display the instant 
PM2.5 level in real time. The sensor is 
permanently active, and the displayed value 
refreshes every second. However, this option 
consumes a lot of power and drains the 
battery in short time. 
Other values that can be displayed: 
> Temperature and humidity display 
> 3-digit battery voltage display (for 
example "384" meaning 3.84 V) 
> When the battery voltage is low, the 
LED display is flashing, indicating that 
recharging Is necessary. 
A connection is provided for optional battery 
charging with a 5V solar cell for outdoor use. 


The menu settings are saved in the internal 
EEPROM of the microcontroller. All other 
values, tables and variables will be reset when 
the unit is powered off or restarted. 


Air quality index calculation 

There are many methods used to calcu- 
late the air quality index. In this project, 
two versions are implemented. The first Is 
averaged over the last 24 hours using the 
calculation method of the USA, details on this 


method can be found at [1]. The drawback of 
this method Is that it uses a moving average 
over 24 hours. Therefore, the value that is 
displayed is influenced by relatively old air 
quality levels. For this reason, a new calcu- 
lation (NowCast) is being used that makes 
a weighted average. The measurement of 
the past hour has a greater weight In the 
final calculation than that of 11 hours ago. It 
is also a sliding average but over 12 hours. 
It is called here NQI (New Quality Index), 
and it keeps the same limits as the version 
above. The link explaining this method in 
detail is given in [2]. To keep it simple, the 
index value of the previous hour has a weight 
of 50 %, that of hour -2 has a weight of 25 %, 
that of hour -3 has a weight of 12.5 %, etc. A 
practical implementation of the algorithm is 
discussed tn link [3]. 


The hardware 

The schematic in Figure 1 shows the 
hardware of this air quality display. The DC/ 
DC boost converter for the PMS7003 sensor 
is a LT3525ESC6-5 (U6). It is a so-called "true 
shutdown" step-up converter. Most DC/DC 
boost converters have a shutdown function 
that will just stop the transistor switching in 
the choke circuit. But then the output voltage 
still follows the input through the diode- 
choke circuit and it still consumes power. 
True shutdown circuits really shut down the 
converter and no current can flow to the 
output. The only real problem with this IC is 
to solder it. It’s really small, solder paste and 
a hot air soldering station are recommended... 


The LP2980 3.3 V (U7) regulator is controlled 
by U1, a MAX931 comparator with hystere- 
sis. It switches the regulator off if the battery 
voltage drops below 3.2 V and can only be 
reactivated if this voltage rises above 3.8 V. 
This function, not necessarily useful in normal 
mode, is necessary when using a solar panel 
for recharging. The MAX931 will also block 
the DC/DC converter via diode D5 to prevent 
unintentional starts in low battery conditions. 
The serial link is shared between the external 
connector J8 (for tracking and downloading) 
and the PMS7003 (connected to J1). The Tx 
signal from the microcontroller is connected 
to both connectors. The Rx signal is sent via 
a D2-D12 diode-OR. As the software does not 
send commands to the PMS in the current 
version of the firmware, the resistor R16 
(0 Ohm) is not mounted. 


For the SHT20/21 sensor, the 12C connection 
is made by software simulation, via portB.0, 
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Figure 1: The hardware of the PM2.5 display. 


portB.1, without using the internal 12C of the 
PIC (which is used for the display). 


The LCD that is used here, an Eastrising Serial 
COG 8x2 LCD Module I2C Character Display 
[7], has an 12C interface and is connected via U3. 


The charger for the lithium battery is an 
LTC4054 (or equivalent EUP8054, U4), It 
can be powered either via USB (J2) or via 






RS5Vlink 


CHRG 
U4 
LTC4054 
PROG 


an external solar panel connected to J4. The 
current is limited by the two resistors R19-R20 
to 400 mA. LED D4 indicates that the battery 
is being charged, It is placed near the USB 
connector. Connector J4 is used to connect 
a 5 V solar panel, which will recharge the 
battery via Schottky diode D7. 


The five bar graph LEDs (D8 to D11 and D13) 
are controlled by the PlC-controller. The 


+V_SENS (+) 2 











R16 


D12 
1N4148 


191215-008 


current limiting resistor of each LED depends 
on the type of LED used (low power or not) 
and on the forward voltage of each colour 
LED. LED D1 (red) lights when the DC/DC 
converter is ON and therefore the particle 
sensor is switched on. 


For the display, capacitors C10 and C11 can 


be between 1 UF and 2.2 uF, 10 V version. 
The display backlight is not used (and can be 
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Figure 2: PCB, battery and PMS7003 sensor with the enclosure opened. 


removed before mounting). It is attached to 
the printed circuit board with double-sided 
adhesive tape. It is recommended to buy the 
display with its connector. 


The brightness for the day/night mode is 
detected by an LDR (C1) placed on the front 
panel. It is connected to analog input ANO of 
the microcontroller. 


Assembling 

the printed circuit board 

The schematic and PCB were designed using 
Novarm’'s DipTrace CAD software, the design 
files can be downloaded from the Elektor Labs 
project page at [9]. All components except for 
the LEDs are SMDs. The most difficult part to 
solder is the DC/DC converter, | used solder 
paste and a hot air soldering station for this. 
Given the compactness of the case, it is diffi- 
cult to mount standard connectors to connect 
the 2 sensors. It is therefore preferable to 
solder the wires directly to the circuit. Only 
the battery and the display use a connector. 


There are two solutions for programming the 
microcontroller. Either connect a Pickit3 to 
J7, or via the serial connector shared with the 
PMS7003 sensor. In this case, the microcon- 
troller must be programmed with a bootloader 
before soldering and the PMS7003 must be 
disconnected each time the uC Is repro- 
grammed. Personally, | always use a bootloader 
called Tiny bootloader, which can be found on 
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the URL in [6]. It is necessary that the version 
embedded in the PIC has the right value for 
the watchdog (here 256 ms) and so the source 
must be recompiled with it. The asm and .hex 
of this bootloader for the PIC18F2520 is also 
part of the software download on the Elektor 
Labs project page [9]. 


Software 

The software is developed in C, with an older 

version of the MikroC compiler. It can be 

ported to the newer version, MikroC Pro, but 

| have not tried it. Source and HEX-file can 

be downloaded from this project’s page on 

Elektor Labs [9]. The firmware is quite simple: 

> Init 

> Infinite loop with button test 

> Display of the different screens, the level 
of the LEDs (depending on the reading of 
the brightness for day/night switching) 

> Every xx minutes, switch on the 5 V DC/ 
DC converter for the particle sensor. 
30 seconds later, the PM2.5 value is read 
and the DC/DC converter is switched off. 

> Every hour, calculation of the average 
value 

> Storage of this value in a 24-position 
moving average table (for 24 hours) 

> Calculation of the IQA (moving 24-hour 
average) or NQI (moving 12-hour 
weighted average) 

The calculation_aqi() function calculates 

the value of the air quality index, following 

the principle of simple average over 24 hours. 


"pe 





e 





Figure 3: Front view of the PM2.5 display in its 3D-printed case. 


A table contains the last 24 values and the 
average Is simply averaged. The calcula- 
tion_nqi() function calculates the weighted 
value of the air quality index. The "practical" 
formula is explained in reference [3]. 


The conversion of these values into indexes 
(0-500) is carried out by the conversion_ 
aqi() function, according to the formula 
indicated in the document [1] for the USA. 


The main loop of the software is terminated 
by a “sleep” instruction. The processor wakes 
up when the next watchdog Is triggered, the 
watchdog interval must be set to 256 ms 
(in the case of the PIC18F2520 this must be 
done when programming the microcontrol- 
ler). This interval is short enough not to miss 
key presses. A longer time would be better as 
far as power consumption is concerned, but 
then it would then be possible to miss button 
presses. The software also works without the 
temperature/humidity sensor attached, but of 
course the display will show invalid values for 
temperature and humidity then. 


Enclosure 

The case was designed in ThinkerCad and 
printed on a 3D printer. It is quite simple, with 
openings for the SHT sensor on the top as 
well as for the PMS7003 sensor, one for the 
air inlet, one for the outlet. The most recent 
version of the design can be downloaded [4]. 
A bracket for a solar cell has also been devel- 


OPERATION 


A long press on the VAL button (S6) 

enters the configuration menu and 

this allows the user to: 

> Change the measurement period 
(10min-60min) with the + and - 
buttons, validated by pressing the VAL 
button. 

> Enable LED level display during the 
night (yes/no) 

> Select which value is displayed on the 
LEDs (last measurement, AQI/NQI, 
average last hour) 

> Select the index to be displayed. (AQI/ 
NQI) 


oped. It is attached to the back of the enclo- 
sure with small hooks [5]. 


The compact, battery powered hardware is 
working great, but this design can always 
be enhanced or improved. For example, the 
schematic and PCB already have a connector 
(J6) for a low power 128 x 64 pixel graphic LCD 
[8], but this is not tested and not supported 
in the current version of the firmware, so J6 
and all capacitors close to it in the schematic 
can be omitted. 


Unfortunately, air pollution is still a growing 
problem, not only in large cities in the Far 
East. It is good to have a PM2.5-display at 
hand to monitor air quality, but to be honest: 
it's actually very bad that we need it. K 
191215-01 
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Pressing the VAL button will scroll 
through the different screens. The 
character on the LCD before the value 
will indicate what value is displayed: 
L: Last, most recent measurement 

H: Hour, the current hourly average 

Q: Quality, Air Quality Index, IQA or NQI 
(depending on menu setting) 

T: Temperature (in centigrade) 

H: Humidity (in %) 

I: Instant, display refreshed every second 


The LED bar graph will show the value 
specified in the menu, except for the 


Contributors 

Idea, Design, Text and Illustrations: 
Laurent Labbe 

Schematic: Patrick Wielders 
Editor: Luc Lemmens, CJ Abate 
Layout: Giel Dols 


RELATED PRODUCTS 





> Velleman Earth Listener Kit 
www.elektor.com/velleman-earth-listener-kit 


[1] Air quality index: https://en.wikipedia.org/wiki/Air_quality_index 


] 
[3] Practical formula for calculating the NQI: www.epa.gov/airnow/faq/Nowcast-formula.pptx 
] 


Enclosure: www.tinkercad.com/things/gznm3a4WifP-new-boitier-dust-11 





Instant value screen. In this case, the 
bar graph shows the index of the last 
value received from the sensor, which is 
refreshed every second. 

The instant value screen shows on the 
second line the value of the number of 
particles returned from the sensor, and 
then the calculated air quality index 
value preceded by the letter Q. 

A display also shows the minimum and 
maximum value of the index during the 
last 24 hours. 


Questions or Comments? 

Do you have questions or comments 
about his article? Email the author at 
laurent.elektor@gmail.com or contact 
Elektor at editor@elektor.com. 








Recalculation of the air quality index (Nowcast): https://en.wikipedia.org/wiki/NowCast_(air_quality_index) 


[5] Solar panel bracket: www.tinkercad.com/things/b3mohl2Dzla-copy-of-copy-of-boitier-dust-6 


[6] PIC bootloader: www.etc.ugal.ro/cchiculita/software/picbootloader.htm 


[7] Alphanumeric display: www.buydisplay.com/character-display/character-display-panel?interface=461&resolution=135 


[8] Graphic display: www.buydisplay.com/1-4-inch-graphic-128x64-lcd-module-serial-spi-st7565-black-on-white 


[9] This project’s Elektor Labs page: www.elektormagazine.com/labs/portable-display-pm25-1-1 


[10] PMS7003 datasheet: 


www.pdf-archive.com/2017/04/12/plantower-pms-7003-sensor-data-sheet/plantower-pms-7003-sensor-data-sheet.pdf 
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From Life's Experience 





The Future Was Better in the Past 


By Ilse Joostens (Belgium) 


The sun was high above the horizon. It was scorching hot and the warm, muggy air 

spiralled above the tarmac while the planes taxied along. Andrew stared, visibly tired and 
with a glassy look, through the window of the business lounge at the busy scene while he 
wiped away the sweat that beaded on his forehead. When he was about to put the paper 
handkerchief back into his belt bag, his view inadvertently crossed a Japanese businessman 
who had taken a seat a few meters away. To the right of his armchair stood two enormous 
suitcases on the carpet and the man appeared to be involved in a heated discussion with 

his watch. Mesmerised, Andrew continued to stare at the man, and when he ended the 
conversation and made a move to get up, Andrew decided, bewildered and curious as he was, 


to talk to the man. 


Napoleon’s inventions 

If you wondered, while reading the intro, whether you picked up 
a novel or an electronics magazine, then I offer you my sincere 
apologies for this flurry of literary insanity. I only wanted to tell you 
the joke of the Japanese man with his two suitcases. I will there- 
fore not withhold the remainder of the story, although in a more 
familiar writing style. 


Says the American to the Japanese: “What are you doing? What 
kind of thing is that?” “This is the very latest gadget from Casio,” 
answers the Japanese man. “All-in-one, radio atomic clock, laser 
pen, camera, you can make video calls, access the internet, faxing, 
manage your diary and you can even swim with it because it is 
waterproof.” “Fantastic!” says the American. “I need one of those too. 
How much does it cost?” “Ten thousand dollars”, says the Japanese. 





The Curta mechanical pocket calculator (Photo: Ilse Joostens), 
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“Deal!” says the American, and pulls out his wallet and pays the 
Japanese. Contented, the American buckles his new acquisition 
around his wrist and notices that the Japanese walks away pleased. 
“Hey, you forgot your suitcases!” shouts the American. “Not at all,” 
says the Japanese. “Those are your suitcases, they belong with the 
watch!” 


When I heard this joke for the first time, GSM telephones had been 
around for only a few years and you could only surf the Internet 
exasperatingly slowly via an expensive dial-up connection, using 
an old-fashioned beeping and screeching modem. At that time, I 
could not imagine that the gadget from the Japanese man in the 
joke would become a common thing, if not actually in the shape 
of a watch, then in the form of a smartphone. Although, with a 
smartwatch, babbling with your watch also belongs to its possibil- 





A mechanical calculating monster. 


ities, but I prefer to use a smartphone. Taking pictures, surfing the 
Internet, making movies, watching videos, managing your diary, 
all this is effortlessly possibly and thank God they have left out the 
possibility of sending faxes. Waterproof they are too, especially 
in the Far East, because admit it, who does not want to use their 
phone in the shower’? 


The smartphone reminds me of the ‘Appendiscope’, a transmit- 
ter/receiver-amulet that passes on images and sound, invented 
by Napoleon in the Flemish children’s TV series Merlina that was 
broadcast in the 1980s. Other inventions by Napoleon too have 
become more or less reality these days, such as the ‘Video glasses’, 
‘Evarist the computer’, the ‘Contradecibel’ and the ‘Holomat’, things 
that as a child you would never even dare to dream about. 


One of the most intriguing things from the same period is one of 
those pocket calculators that I received as a10 year old, as a present 
from Saint Nicholas via the bank that my father worked at. It was 
a Clover 2001 and apparently the device is not only very frugal 
with energy, it must also have very good batteries. I can still use 
it to perform calculations, although the display has become very 
faint. It is just unbelievable that after nearly 40 (!) years there is still 
sufficient energy in the original batteries. At the same bank, in the 
‘60s and '70s, they were still using mechanical pocket calculators. 
These were not only complex and expensive, but often also bulky 
and heavy. A remarkable mechanical ‘pocket calculator’ (yes, it 
actually exists!) and these days a popular collector's object is the 
Curta calculator, also known as the pepper mill or the math grenade 
because of its shape. The Curta, which was used into the '80s by 
rally pilots, is not only a staggering example of precision mechan- 
ics, the contrast with the pocket calculator that you receive free in 
a store promotion or from an insurance agent could not be greater. 


Pipe Dreams 

Starting with the often funny predictions from the past, the future 
in the year 2000 looked a whole lot better than what the reality 
turned out to be, but that won't stop me from making a few predic- 
tions myself. 


You may have seen the TV advertisement of the supermarket chain 
Caltex where an old lady walks through a shop with a squeaking 
trolley. A friendly shop assistant decides to help her and uses a can 
of oil to lubricate the wheels of the trolley. But just as he finishes, 
the lady realises that she has forgotten something and she walks 


Questions or Comments? 

Do you have any technical questions or comments about this 
article? Send an email to the author or to the editor of Elektor 
via editor@elektor.com. 
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Calling from the shower — how has humanity been able to survive without 
this ability? 


squeaking without a trolley to the fresh food department. This could 
therefore be much improved and I expect that the future will reveal 
a revolution in implants and prostheses — a bionic human, you 
could say. 3D-printed organs and less-invasive surgical techniques 
will experience an entire evolution also, according to me. 


And artificial intelligence will play an increasingly greater role — 
with the risk that 1984 by George Orwell will become increasingly 
closer to reality also. Further, I also anticipate an important role for 
small nuclear reactors such as the “Travelling Wave Reactor’ (TWR) 
and perhaps we will follow ‘Perseverance’ and some day set foot 
on the red planet in a manned Mars mission. 


What do you think the future will bring? Polish your crystal ball 


and let us know! [<q 
210185-01 


=—— WEBLINKS 





[1] The sound of a dial-up connection: 
www.youtube.com/watch?v=gsNaR6FRuOO 


[2] Merlina: https://nl.wikipedia.org/wiki/Merlina 
[3] Curta calculator: wwwvcalc.net/cu.htm 


[4] Curta calculator: 
https://satadorus.eu/x_Ite/yacs_2_0/yacs_2_0.html 


[5] Obsolescence of technology: 
https://youtu.be/zbsq4-KwnE4?t=51 


[6] Caltex advertisment: https://youtu.be/aLmWU7cCW10 
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icroPython 


for the ESP32 and Friends 


Part 1: Installation and Our First Programs 


By Dr. Gunter Spanner (Germany) 


Python is more and more coming to replace C 

as the programming language of choice, and 

this trend can now also be seen in the world of 
microcontrollers. Taking the ESP32 as an example, 
this article will look at how to program a modern 


microcontroller in MicroPython. 


In recent years, Python has seen a massive upsurge in popularity, 
not least because of the availability of single-board systems such as 
the Raspberry Pi. But Python has also found broader application in 
other areas such as artificial intelligence and machine learning. It 
therefore seems natural to look at how we can employ Python (or 
the MicroPython variant at any rate) in microcontroller projects. 


This article will look at the basics of MicroPython, and in partic- 
ular at the most important commands and libraries available. 
We will use an ESP32 microcontroller to demonstrate a couple 
of small applications: the microcontroller will be programmed 
with firmware that interprets the Python commands. The Python 
program itself is written using a development environment that 
runs on a PC, and Python commands can be sent from the PC to 
the microcontroller either as an entire program or one at a time. 
That can be done either over USB or over a wireless network. Let’s 
look at these aspects one by one. 
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Required Parts 

1. Small breadboard * 

2, ESP32-PICO-KIT V4 * 

3. Red LED 

4,150 Q resistor 

5. SSD1306-based display module * 
6. Wire links 


* Available from the Elektor Store. 





Programming and Development Environments 

In contrast to the Arduino ecosystem MicroPython can work witha 
range of integrated development environments, or IDEs. Currently 
the two most widely-used environments are: 


1. uPyCraft 
2. Thonny 


Also, we might consider installing Anaconda Navigator, which is 
primarily used for programming microcontrollers in the field of 
artificial intelligence. Each approach has its own particular advan- 
tages and disadvantages. For example, the uPyCraft IDE offers only 
a comparatively unsophisticated user interface, using simple graph- 
ical elements reminiscent of text-oriented operating systems. 


Thonny, on the other hand, offers a complete graphical user inter- 
face in the style of Windows (see Figure 1). This IDE is very popular 








in the maker community, in particular because it is available for 
the Raspberry Pi running under the Raspbian operating system. 
Many Raspberry Pi users are therefore already very familiar with 
Thonny. Thonny runs on all the major operating systems including 
Windows, Mac OS X and Ubuntu Linux, and is available for free 
download on the Internet [1]. 


Before using Thonny it is necessary for Python 3 to be installed 
on the machine that will be used for development. If that is not 
already present, you can find the installation instructions on the 
relevant website [2]. 


Next, we can install Thonny itself from [1]. First select the appro- 
priate operating system at the top right of the page. Launching the 
downloaded file will start the usual installation process. The IDE 
is now ready to develop our first Python application. 


Installing the Interpreter 

The next step is to install the MicroPython firmware itself. This 
can be obtained from the official MicroPython website [3], where 
you will find a range of microcontroller options available. In this 
article we will be looking specifically at the ESP32, and so we need 
to download the latest version compatible with this microcontroller 
type. Under Espressif ESP-based boards click on the image whose 
caption is Generic ESP32 module. The page that now opens offers a 
number of different firmware variants. Notice that the most recent 
version of the firmware is often marked as ‘unstable’. This option 
is aimed rather at the developers of the interpreter firmware itself 
and others of an adventurous disposition. Those of us who prefer 
a more stable system should select the most recent version that 
is not marked as ‘unstable’, for example: 


File Edit View Run Device Tools Help 


Dhd Oo > © 
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<untitled> ~ 
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GENERIC : esp32-idf3-20200902-Vv1.13.bin 
Click on the appropriate link and the firmware will be downloaded. 


Now we can connect the microcontroller board (for example, an 
ESP32-PICO-KIT: see the Required Parts text box) to the PC over USB 
and then launch the Thonny IDE. Here we need to choose the Select 
interpreter entry in the Run menu, which opens the Thonny options 
window: see Figure 2. Under the Interpreter tab there is a range 
of options to choose from, including ones specific to the ESP32. 


Under Port select the USB port to which the ESP32 is connected. 
Alternatively, you can select the option Try to detect port automat- 
ically. This, however, does not work reliably in every case. 


Clicking in the box under Firmware will now start the installer. The 
port is not configured automatically and must be entered again. 
Then navigate to the firmware that we downloaded above. Clicking 
on Install will start the installation process. When the process is 
completed the window remains open: close it and you are ready 
to start programming your ESP32 in MicroPython. 


Libraries 

Working with Python means working with libraries. Writing every 
program from scratch is, to say the least, highly inefficient, and the 
overwhelming success of Python is in large part down to the range 
of libraries available for it. Unfortunately, not all libraries can be 
operated within the confined resources of a microcontroller, and 
so a special selection of libraries has been developed for use with 
MicroPython. Many of these are available as a standard part of the 
download of the Thonny IDE. 


Interpreter | Editor | Theme & Font | Run & Debug | Terminal | Shell | Assistant 


| MicroPython (ESP32) 


Connect your device to the computer and select corresponding port below 
(look for your device name, "USB Serial" or "UART"). 
If you can't find it, you may need to install proper USB driver first. 


ice should Thonny use for running your code? 








Port 
< Try to detect port automatically > [y] 











Firmware 


Open the dialog for installing or upgrading MicroPython on your device 
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The two most important standard libraries in MicroPython are 
machine and time. The import command is used to make the 
libraries available for use on the microcontroller. The following 
approaches (among others) can be used to make a library function 
accessible: 


> import module 
> from module import name 


In the first case, the whole module is imported; in the second case, 
only the specified functions are brought in. 


The machine module contains functions specific to the hardware 
of a particular microcontroller. These functions allow direct and 
unfettered access to and control over hardware components includ- 
ing the CPU, timers, buses and input/output pins. Be aware that 
misuse of this module can cause errors, crashes, and, in extreme 
cases, even damage to hardware. 


The Pin class is one of the most important parts of the machine 
module. A Pin object is used to control an input/output pin and 
conventionally a Pin object is assigned to a physical pin on the 
microcontroller. The object allows output levels to be controlled 
and input levels to be read. 


The Pin class provides methods to set the mode of the pin. For 
example, IN and ouT can be used to configure a pin as an input or 
an output respectively. 


The time module provides a range of time-related functions. The 
sleep Class from this module pauses the execution of the running 





94 July & August 2021 www.elektormagazine.com 





File Edit View Run Device Tools Help 


Daa OC = @ 











MicroPython device 


This computer 

>>> from machine import Pin 
>>> led=Pin(2,Pin.OUT) 

>>> led.value(1) 

>>> 


= Windows (C:) 











program for a specified number of seconds. The argument can 
even be a floating-point value, allowing exact delays of a fraction 
of a second to be specified. The commands 


from machine import Pin 


from time import sleep 


make the Pin and sleep functions available. With the first of these 
we can talk to the individual port pins of the microcontroller, and 
with the second we can implement time-based functionality. Using 
the command 


led = Pin(2, Pin.OUT) 


we can create an object led which is associated with I/O pin 
number 2, and configure this pin as an output. We can now 
pass various values to this object. For example, if we execute the 
command 


led. value(1) 


then the value 1 will be written to the object. In turn that means 
that the associated I/O pin, pin 2, will be set to a high voltage level. 
In the case of the ESP32 this is 3.3 V. 


The REPL Console 

It is possible to monitor the state of a port pin by simply connecting 
an LED to it via a current-limiting resistor. (Figure 3 shows how 
this is done, as well as how we can go a step further, connecting 
up a full OLED panel: more on that later.) 


The port, and hence the LED, can be controlled very simply using 
what is called the ‘REPL console’. REPL stands for ‘Read Evaluate 
Print Loop’, which is an interactive MicroPython entry method that 
allows us to execute commands directly on the ESP32. The REPL 
console thus gives us a very simple way to test out commands and 
execute programs. 


The REPL console is called the ‘shell’ in Thonny and is available at 
the bottom right of the main window. You can enter the commands 
from the excerpts above directly in this box: see Figure 4. 


After entering the last of the above commands the LED should 
light up. The command led.value(@) can be used to turn the LED 
off again. 


The REPL console has a few interesting features that make 
working with MicroPython very convenient. For example, previ- 
ous command lines are stored, and the up and down arrow keys 
can be used to recall previously entered commands are required. 


Another handy feature is tab completion. Pressing the ‘Tab’ key 
on the keyboard will automatically attempt to complete a partial- 
ly-entered word. This can even be used to obtain information on 
the functions and methods available in an module or applicable 
to an object. 


For example, entering ‘ma’ and pressing the ‘Tab’ key leads to an 
automatic completion to ‘machine’ (assuming that the machine 
module has already been imported as described above). Now 
pressing the full stop key (“’) and then ‘Tab’ again will bring up a 
complete list of all the functions available in the machine module: 
see Figure 5. This feature in many cases makes it unnecessary to 
look up commands, objects and methods in the documentation. 


Wireless Access Using WebREPL 

One of the major advantages of the ESP32 is its excellent support 
for wireless connectivity. So what could be more natural than to 
make the REPL console available over such a connection? To do 
this we can use the WebREPL interface. 


Shell = 


MicroPython v1.13 on 2020-09-02; ESP32 module with ESP3?2 
Type “help()" for more information. 
> > > Run i C ErMmaTT An CATA 


PIN_WAKE 


BON RESET 


MicroPythor§, 
Type "he - 


>>> machine.| 





The first step to get WebREPL up and running is to ensure that it 
is installed and enabled on the ESP32. By default WebREPL is not 
enabled and must be switched on using the one-time command 


import webrepl_setup 


over the serial port. You will be offered the options of enabling or 
disabling the feature, and for setting a password. After configura- 
tion the ESP32 must be rebooted. 


To use WebREPL over a wireless network the ESP32 must first 
be connected to that network. To do that, issue the following 
commands to the serial REPL console. 


import network 
wlan = network.WLAN(network.STA_IF) 
wlan.active(True) 


wlan.connect(’ssid’, ’password’ ) 


The placeholders ssid and password should of course be replaced 
with the credentials for your local wireless network. The command 


wlan. 1fconrig() 


will then display the IP address settings which the ESP32 is using 
to communicate with the network: see Figure 6. The commands 


import webrepl 


webrepL.start() 


will now enable the WebREPL client. In a web browser you can go 
to the address 


http: //micropython.org/webrepl/#xxx.xxx.XXX.XXX:8266 


where for xxx.xxx.xxx.xxx you should substitute the IP address 
determined above using the wlan. ifconfig() command. You can 
then use the Connect tab to connect to the ESP32 using the password 
that you previously configured as part of the setup process. 


[ WLAN_connect ]* ~ 


import network 

wlan = network.WLAN(network.STA_IF) 
wlan.active(True) 

wlan.connect( ‘SCT 


Type “help()” for more information. 

>>> *%Run -c $EDITOR_CONTEN 

>>> wlan.ifconfig() 

PMR enh ee gt (ee ee go RR Ni, Ace at) 


>>> 
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When WebREPL is started up, you may find that the console is in 
‘raw REPL’ mode. This allows the direct entry of commands using 
copy and paste. In such situations, you can press control-B to switch 
to normal mode, which allows for normal entry of commands. 


We are now in a position to control the ESP32 entirely wirelessly. 
The simple output switching commands already allow us to 
implement basic home automation functions: see Figure 7. Ifa 
suitable file system is installed on the ESP32 it is also possible to 
perform software updates wirelessly, also known as over-the-air 
(OTA) updates. When working with WebREPL, it is worth bearing 
in mind that it is something of an experimental feature, and so 
might not be expected to work absolutely reliably in all situations. 


Program Control 

The REPL or WebREPL console is best suited for testing out ideas. 
For conventional program development the editor panel (above 
the REPL console in the Thonny window) is more suitable. There 
we can for example prepare the program described below which 
is designed for automatic control of night-time lighting and stair- 
well illumination: see Figure 8. 


Once the code has been entered and started using the start icon 
(white arrow in a green circle), you will be prompted to save the 
program. Here, choose the option MicroPython device and enter 
a program name (for example, Automatic_LED) and confirm the 
save operation. The LED will now light for three seconds and then 
automatically extinguish. If you press the start button again, the 
program can be re-run immediately. 


To turn this into the classic ‘blinky’ flashing LED demonstration 
program, we simply need to add awhile statement. This will cause 
a given command or block of commands to be executed repeatedly. 
The particular case of while True: creates an endlessly-repeating 
loop: in this case, that means that the LED will flash continuously. 


i MicroPython WebREPL 


Siar deed, is 
O & 


8266 


© Nicht sicher 


| micropython.org/webrepl/#192.1¢ 31.3.1 


Disconnect 


ws://192.10%3.175..%:8266 


Password: 

WebREPL connected 

>>> from machine import Pin 
>>> from time import sleep 
>>> Led = Pin(2, Pin.OUT) 
>>> Led.on() 

>>> 
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from machine import Pin 


from time import sleep 
led = Pin(2, Pin.OUT) 


while True: 
led.on() 
sleep(0.5) 
led.off() 
sleep(0.5) 


Observe here that the while statement must be terminated in a 
colon. The following block of commands is, in accordance with 
the standard Python convention, indented by a constant amount 
of white space. Thonny provides this indentation automatically: 
as soon as you enter a colon followed by the Return key, the cursor 
will appear in the next line indented by one step. And of course, the 
program editor also offers the tab-completion feature. A running 
program can be halted by pressing control-C. 


MicroPython in a Nutshell 

Although the lifeblood of MicroPython is its collection of libraries, 
a decent grasp of the basic commands is necessary to understand 
others’ programs and to write one’s own. We will therefore now 
look briefly at the most powerful MicroPython commands. 


Simple comments are introduced by the ‘#’ symbol. The comment 
runs from the ‘#’ to the end of the line. 
>>> print("hello ESP32") # this is a comment 
hello ESP32 


Comments are ignored during program execution; they are only 
there to provide information to the program developer. The print () 
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from time import sleep 
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7 sleep(3) 
8 led.off() 
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Related Products 


> Book: MicroPython for Microcontrollers 
www.elektor.com/micropython-for-microcontrollers 


> ESP32-PICO-KIT V4 
www.elektor.com/esp32-pico-kit-v4 


> Breadboard 
www.elektor.com/breadboard-830-tie-points 


> SD1306-based display module 
www.elektor.com/blue-0-96-oled-display-i2c-4-pin 


command used here allows information to be output to the console, 
whether text-based or numerical; on the other hand, you can also 
call print() directly from the terminal window. 


As we saw above the in LED ‘blinky’ example program, statements 
can be grouped together into blocks identified by their indentation. 
That means that braces (‘{‘ and ‘}’) and other similar mechanisms 
are not needed. The advantage of this approach is one is more or 
less forced into a structured programming style. 


Itis very easy to create a variable in MicroPython, and in particular 
it is not necessary to specify the type of a variable. Variables can 
also be used directly in the console as follows. 


>>> a=17 
>>> b=12 
>>> print(axb) 


204 


In MicroPython the arithmetic operators have their conven- 
tional mathematical interpretations. Besides addition, subtrac- 
tion, multiplication and division we also have the // operator for 
integer division, % for modulo (or remainder from division), and 
xx for exponentiation. 


The usual branching and looping statements are also provided in 
MicroPython. Branching is supported by the keyword if, followed 
by a condition; if the condition is true then the next statements are 
executed. An else keyword may follow, introducing a set of state- 
ments to be executed instead if the condition is false. For example: 


if True: 
# block 01 
print ("True") 
else: 
# block 02 
print ("False") 


Loops provide a facility to repeatedly execute statements. A set 
of statements is executed for as long as a specified condition is 
fulfilled. Two variations are available: 


> ‘while’ loops 
> ‘for’ loops 





So, one way to print the numbers from 1 to 9 on the console would 
be to use a whi le-loop as follows. 


number=1 
while number<10: 
print (number) 


number=number+l 


The set of statements to be repeated is indicated by the indentation. 
This task can equally be carried out using a for-loop as follows. 


for number in range(1, 10): 


print (number) 


Automatic Alarm Signal 

With these basic programming structures under our belt, we can 
now create our first practical application program. The following 
program is an automatic SOS beacon that could be used to signal 
a sailing or climbing emergency. 


from machine import Pin 
from time import sleep 
Led=Pin(2,Pin.OUT) 


while True: 

for n in range(3): 
led. value(1) 
sleep(.1) 
led. value(0) 
sleep(.5) 

sleep(1) 

for n in range(3): 
led. value (1) 
sleep(.4) 
led.value(0) 
sleep(.5) 

sleep(1) 

for n in range(3): 
led.value(1) 
sleep(.1) 
led.value(0) 
sleep(.5) 

sleep(2) 


The OLED Panel: A Small-Format Display Screen 

It is certainly possible to use a single LED to communicate useful 
information, for example using Morse code as in the SOS beacon 
application above. A considerably more modern approach is of 
course to display data on an OLED panel. A common variety of 
such panels uses the SSD1306 display controller. For this example 
we use a display unit with a diagonal of just 0.96 inches (about 
2.5cm) anda resolution of 128 by 64 pixels. 


MicroPython comes as standard with a library for SSD1306-based 
displays. The library allows for the display of textual and numerical 
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data as well as for the creation of simple graphics. 


The simplest types of SSD1306-based modules are interfaced using 
just four pins, which is enough to drive the display using the I?C bus 
protocol. The connection to the display is illustrated in Figure 3, 
and the required connections are also set out in tabular form below. 














OLED pin ESP32 pin 
VDD 3v3 

GND GND 

SCK GPIO 22 
SDA GPIO 21 


The script shown in Listing 1 outputs a text message to the display 
and draws some simple graphics in the form of a box outlining it 
(as appears in Figure 3). 


The relevant library is available as a standard package (ssd1306.py 
in the download archive [5]) and can be uploaded separately to the 
board. The pins used for the I2C interface are declared as follows. 


2c = I2C (-1, scl = Pin (22), sda = Pin (21)) 


The first parameter, ‘-1', indicates that the module that is used does 
not feature a reset or an interrupt pin. The number of horizontal 
and vertical pixels in the module is specified using the command 


oled = SSD1306_12C(128, 64, i2c) 


The display is now ready for use. The function text() can be used 
to write information to the display buffer, and the display itself is 
updated using the show() method. The text() function accepts 
the following arguments. 


> the message (a string) 
> x- and y-coordinates for the text in pixel units 
> optional text colour: o for black (not lit) and 1 for white (lit) 


The show() method makes the changes visible on the display. The 
rect() method lets you draw a rectangle on the display. It accepts 
the following arguments. 


> x- and y-coordinates for the bottom left-hand corner of the 
rectangle 

> x- and y-coordinates for the top right-hand corner of the 
rectangle 

> pixel colour: o for black and 1 for white 


The command 

oled.rect(5, 5, 116, 52, 1) 

therefore conjures up a rectangular frame near the edge of the 
display. With just these simple commands it is possible for an 


application to display all sorts of information, from basic text to 
complex sensor readings. 
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Listing 1: Message on the OLED display. 


from machine import Pin, I2C 
from ssd1306 import SSD1306_12C 


12c=I2C(-1,scl=Pin(22) ,sda=Pin(21) ) 
oled = SSD1306_12C(128, 64, i2c) 
lLin_hight = 9 

col_width = 8 


oled. fill(0) 

oled.text("Hello", 5xcol_width, 2*lin_hight) 
oled.text("MicroPython", 2*col_width, 
4xlin_hight) 


oled.rect(5; 5; 16,7 52,1) 
oled.show() 


Outlook 

MicroPython is a modern and powerful programming language. 
Furthermore, its libraries allow complex projects to be realized 
quickly and easily. In this article, we have shown how to install a 
suitable IDE and create some simple applications. In the second 
part of this series, we will examine further aspects of MicroPython 
and, as a practical demonstration, give an example of how to drive 
a large-format LED dot-matrix display panel. 


Further information about MicroPython, about the ESP32 micro- 
controller, and about the examples presented here can be found 
in the book MicroPython for Microcontrollers [4]. M€ 

210179-01 


Contributors 

Text and illustrations: Dr. Gunter Spanner 
Editor: Jens Nickel 

Translation: Mark Owen 

Layout: Harmen Heida 


Questions or Comments? 
If you have technical questions or comments about this article, 
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Charge-Coupled Devices 


In Oscilloscopes 


By Neil Gruending (Canada) 


Peculiar Parts, the series 


I bet that the first charge-coupled device (CCD) you can think of is a CMOS camera sensor. 

In addition to them being used in millions of camera sensors, did you know that they have 
been used in other ways as well? Here we look at how Tektronix used them to improve the 
sampling rate in their early digital sampling oscilloscopes. 


A charge-coupled device is constructed just like it sounds: it’s an 
array of metal-oxide capacitors (MOS) interconnected by MOSFETs, 
like the Philips TDA1022 [1] shown in Figure 1. When an analog 
signal is connected to pin 5, it will be shifted to the right when the 
MOSFETs gates are clocked by two out-of-phase clocks applied to 
pins 1 and 4. Such devices were initially created to replicate a delay 
line for analog circuitry, but people soon realized that they could 
also be used as memory storage. 


As we all know, traditional analog oscilloscopes draw the measured 
signal on the CRT, providing a very accurate result for repetitive 
signals. But when measuring very slow signals or fast transients, 
signal clarity can be challenging to achieve without a digital 
oscilloscope. 


One of the first digital-sampling oscilloscopes was the Tektronix 
2440 (Figure 2). At the time of its development, the designers faced 
a serious problem because the analog-to-digital converters (ADCs) 
of the era weren't fast enough to sample high-speed digital signals. 
The clever solution that the Tektronix designers came up with 
was to place a fast-in, slow-out (FISO) analog shift register before 
the ADC. The FISO was actually a CCD array designed to sample 
the signal being measured at high sample rates (fast-in) and then 
buffer it for later processing (slow-out). In the Tektronix 2440, the 
FISO was large enough to buffer all of the frame’s sample points. 


This FISO approach was also used in TDS300 and TDS600 oscillo- 
scopes as they had relatively small sample-memory sizes. Unfortu- 
nately, it’s difficult to increase the sample memory without using 
much faster ADCs and storing the sampled data directly into a 
RAM, which is the approach the TDS700 series took. That series 
increased memory and sampling capabilities, which also led to 
digital phosphor displays that mimic analog displays more closely. 
You won't encounter these designs in many places unless you have 
one of these old-style scopes. If you don't, you should definitely 
collectone...ortwo! kK 
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Figure 2: The Tektronix 2400 two-channel 300 MHz, 500 MS/s digital 
sampling oscilloscope from the late 1980s (Source: tekwiki [2]). 


Questions or Comments? 
Do you have technical questions or comments about this 
article? Email Elektor at editor@elektor.com. 


= WEBLINKS 
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[2] 


TDA1022 Bucket Brigade Delay Line for Analog Signals 
Datasheet: http://bit.ly/3cUVQAW 


Tektronix 2440 page on tekwiki: 
https://w140.com/tekwiki/wiki/2440 
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The Invisible Destroyer 


Components Trashed by a Bolt from the Blue 
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The tragic docking accident of the Hindenburg in Lakehurst (Image: Sam Shere), 


By Peter Beil (Germany) 


As the node dimensions of the latest chips The transatlantic journey made by the Hindenburg airship in 1937 
get ever smaller they are becoming more ended in catastrophe. When it was approaching the mooring pylon in 


d vata db Lakehurst, America, 200,000 cubic meters of hydrogen, used to keep 
ANG MOTE SENSIUVE LO Adllage Cause yi the Hindenburg aloft, caught fire (Figure 1). The source of ignition has 


electrostatic discharge. Let’s take a closer never been officially attributed but many experts suspect it was the 
look at what it’s all about and how we can result of a discharge of static electricity between the airship structure 


bia i and the steel mooring pylon. The correct term for this type of event is 
mitigate the potential threat. ESD, or electrostatic discharge. 


What Is ESD? 

This event is the sudden electrical discharge between two objects or 
bodies carrying different levels of electric charge. The charge differ- 
ence is neutralized when the two bodies get close enough together 
for discharge to occur often producing a spark and cracking sound. A 
common method to give an object an electrical charge is by the action 
of rubbing or friction with another material, the so-called ‘triboelec- 
tric’ effect. You must have noticed this when humidity levels are low 
and you comb or brush your hair. Walking over a carpet made from 
synthetic material or leaving your car seat will also produce a charge 


100 July & August 2021 www.elektormagazine.com 


on your body. Now when you reach out to touch another conductive 
object or door handle (Figure 2) which is carrying a different charge 
level you may feel a discharge via your fingertip as the two charge 
levels neutralize. The spark generated when the Hindenburg docked 
presumably ignited the highly flammable gas. With its large surface 
area and the action of air friction, the voltage difference between the 
zeppelin’s body and the pylon could easily have been a few hundred 
thousand volts and the current peak during discharge would have 
been quite large. 


On a smaller scale you will have already noticed this phenomenon 
every day when, for example, you take off a cotton sweater worn over 
an undershirt made of synthetic fibers, you can hear a distinct crackling 
sound. The voltage differences generated by this action can easily rise 
to a few kV. At night your dark-adjusted eyes will see these tiny lightning 
bolts even from a 5 kV discharge. Sneakers or training shoes are almost 
always made of synthetic materials; walking across a hard plastic floor 
can result in a 15 kV charge and carpets can raise the level to 25 kV. 


As we go about our normal daily routines our movements will gener- 
ate some level of charge. This is particularly troublesome when the 
humidity is low for example in air-conditioned rooms or in heated 
environments in winter. Usually you will not be aware of it but just by 
getting up from and returning to a chair can quickly produce a voltage 
difference of 15 kV. You will only be aware of a discharge from a single 
point on your body when the potential difference is above 2 to 3000 V. 
Lower voltage discharges will mostly go unnoticed. 


Plugging some of these figures into the standard HBM (Human Body 
Model) [1] we can see that the electrical equivalent model of a human 
body has a capacitance somewhere between 100 and 300 pF. Assum- 
ing an average skin contact resistance of around 1.5 kQ, at discharge 
we can expect a 15 kV voltage difference to generate a peak current 
of up to 10 A for a few tens of nanoseconds. 


The Impact on Electronics 

All these unwanted discharges are of course relevant for any engineer 
or maker working with low power electronic components. Even though 
we may not be aware of them, discharges at the lower end of the human 
perception threshold can have a catastrophic affect on tiny electronic 
structures. Careless handling has already signed the death warrant to 
countless chips. Touching a modern IC with bare hands can result in a 
destructive discharge of static electricity within the component. Scaling 
up, this is equivalent to a lightning strike hitting a tree (Figure 3). 


Of course, It’s not only the voltage level that's relevant; we need to 
look at the electrical energy discharged during the charge equalization 
process. ESD is a transitory event lasting just a few nanoseconds - but 
the tiny structures around an IC input area in the chip are just a few 
micrometers In size. At 15 kV and 150 pF this amounts to an energy 
of around 17 mWs stored by the human capacitor, according to the 
formula E = 2C x V2. Although this figure Is quite low, the high speed 
of discharge results in a very high instantaneous electrical power in 
the kW range which translates to a very high power density passing 
through the tiny structures. 











Figure 2: Charge dissipation can be painful. Don’t touch 
that handle! (This and other images: Beil & Kaiser). 
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Figure 3: A charged finger can have the same effect on an 
IC that a charged cloud can have on a tree. 





Figure 4: An electron microscope image of the damage 
done by an ESD. 


Looking at ESD damage through an electron microscope reveals 
frazzled connections, craters and charred remains of the tiny explo- 
sion that occurred on the silicon (Figure 4), reminiscent of a scaled 
down lightning strike. Incidentally, these dangers are not only a threat 
to highly integrated ICs, where we are now fabricating structures in 
the nanometer range, but also diodes, LEDs, MOSFETs and even 
power semiconductors. 


Many active electronic components can be destroyed as a result of 


‘lower’ voltage discharges around 1 kV which we cannot perceive of 
ourselves. This is why such damage often goes unnoticed... It's pretty 
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Figure 5: An ESD-safe workplace using all protection measures. 


obvious when an entire component fails but if only part of an IC or a 
certain function Is affected, the damage may remain hidden for longer. 
This can have major life-threatening consequences later on down the line 
when the damaged component is in use, for example, in safety-critical 
applications such as laser monitoring equipment used during delicate 
heart procedures or to control airbag deployment when your car is 
involved in a collision. 


Guard Against ESD 

To reduce the damage that ESD events can have on electronic devices 
it's important that everyone handling components is aware of the 
dangers and will take appropriate steps to combat the problem. In a chip 
fabrication plant every step in the manufacturing process from wafer 
production to back-end right up to component testing is designed in 
such a way to eradicate any chance of component damage by charge 
accumulation. The finished chip may be used in a safety-critical control 
system where device reliability is of vital importance. Even at home 
in the hobby lab, a good appreciation of ESD phenomenon can help 
reduce frustration and unexpected chip failure. 


Since the problem is so important, semiconductor manufacturers and 
designers take appropriate measures to build in some protection into 
the chip design. This is known as ‘ESD hardening’ and uses protection 
circuits integrated into the chip design. You can however only provide 
protection against certain ESD events. As the chip component count 
increases and the fabrication technology shrinks with every new gener- 
ation of chips, distances between features on the chip are smaller and 
are more susceptible to ESD damage. In the case of microcontrollers, 
external voltage-clamping circuits based on suppressor diodes are 
also used. Similar to Zener diodes, these start to conduct when an 
input signal approaches Its specified upper or lower input level. They 
respond quickly and can safely sink relatively high charge levels. Unfor- 
tunately, even such solutions do not guarantee one hundred percent 
protection. A detailed article [2] has already been published on this 
subject in Elektor. 


A basic requirement when working with highly integrated ICs is a 
dedicated ESD protected zone. In this environment measures are put 
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Figure 6: Official ESD logo. 


in place to prevent the generation of static charges and ensure they are 
safely discharged to ground potential in a controlled manner (Figure 5). 
This zone may only be entered by appropriately trained and kitted- 
out specialist staff and is marked with the logo shown in Figure 6. 


ESD protected zones are typically equipped with a conductive, ‘earthed’ 
floor covering. Shelving and work surfaces all have leakage resis- 
tances < 100 kQ in order to dampen any sudden changes in charge 
levels and ensure that any charge can slowly dissipate. Materials with 
a low surface resistance help minimize any static build up and the 
grounding measures allow the charge to leak away to earth potential. 


Movable shelving, trolleys and chairs have conductive surfaces as well 
as conductive castors. The same applies to tools such as soldering 
irons, etc. Insulated plastic handles on hand tools can support large 
potential differences. Electrostatic-conductive materials are therefore 
recommended here, these ensure a well moderated charge equaliza- 
tion process between hand, tool and component. 


One thing to be aware of here is that these conductive tools are not 
suitable for use with voltages > 25 V which means in Germany they 
are not VDE compliant! 


Tweezers and other pointed tools deserve special attention here; the 
tip shape has the effect of producing a concentrated area of electri- 
cal charge carriers which can lead to discharges and sparks even at 
relatively low voltage levels. When working with sensitive compo- 
nents, a wrist strap (Figure 7) connected to a specified grounding 
point is essential. 


In some environments, such as clean rooms, the use of some materi- 
als which can harbor electrical charge is unavoidable for process 
engineering reasons. Any charge building up on these non-conduct- 
ing surfaces can be neutralized by ionizers in the air conditioning 
system; the charge cannot be removed by using conventional ground- 
ing methods (Figure 8). The use of ionized air is only as an addition 
to, but should never be considered as a replacement for conventional 
ESD protection measures! 





Safeguarding PCB Assembly 

For automated PCB production, component placement machines will 
avoid any unnecessary component movement or sliding which may 
produce a charge on the component. Nowadays machines based on 
the ‘pick-and-place’ component mounting method are used mainly, 
here a gripper arm will pick the component and mount it onto the 
PCB. Sensors in the gripper can measure the component properties 
in transit and reject any which are out of spec. 


Anyone entering an ESD-safe zone will only be admitted if they are 
wearing appropriate footwear and special work clothing. To make 
sure all workers comply there is usually an entrance barrier. This will 
only allow access after the person's conductivity is measured. By 
stepping on a floor plate and placing your hand on a pad (Figure 9) a 
measurement is made of your conductivity and the barrier is controlled 
to allow or block access. Visitors to the area can be provided with 
a discharge tape for their shoes and a cotton work coat. Inciden- 
tally, this coat needs to be completely closed. Static electricity can 
be locked in, so to speak: any charge will be contained on inside 
surface of the overall. 





Figure 7: Earthed wristband. 


Related Products 


> Bernstein 4-620 ESD Screwdriver set (6 pieces) 
wwwelektor.com/bernstein-4-620-esd-screwdriver-set-6-pieces 


> Bernstein 2100 ESD Tool Holder VARIO (holds 6 tools) 
wwwelektor.com/bernstein-2100-esd-tool-holder-vario-6-tools 


Special restrictions apply in semiconductor production areas in a clean 
room environment. Here you need to wear suits that cover the entire 
body except for your eyes and hands. Conductive carbon fibers are 
also woven into material that these suits are made from (Figure 10). 
It may also be necessary to wear dissipative finger stalls or gloves. 


There are other situations where unwanted ESD events can become 
visible or even audible: 35 mm film cassettes consists of a spool of 
plastic material coated with a light-sensitive emulsion. In dry condi- 
tions tiny discharges can occur on the surface as the film is unwound 
and surfaces separate. These flashes of light will show up on the 
print when the film is developed. Something similar can happen with 
magnetic tape sound recording especially when using high tape 





Figure 8: lonizing ventilation equipment in the ceiling of a 
chip production facility. 





Figure 9: Conductivity check barrier at the entrance to an 
EPA. 


Figure 10: A cleanroom environment, 
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speeds and wide tape materials. This can result in a faint crackling 
sound on the recording which can be removed with a low-pass filter 
in the audio path. Back to the electronics... 


ESD events are transient in nature and it has only really been possi- 
ble to record their current and voltage profiles in the last few years 
because of the availability of fast storage oscilloscopes with sampling 
rates > 1 GHz. Sampling intervals of < 1 ns are required because the 
events are so very brief. Values of field strength can be measured, for 
example, with an electrostatic fieldmeter. All of these measurements 
are described in the specification [3]. 


ESD and the Small Lab 

Makers and other operators of smaller electronics labs will wonder 
whether they really need to take this topic so seriously. Let's be clear: 
The same physical laws apply at home as in the production halls of 
large-scale industry. Therefore, don't scrimp on your ESD protective 
measures. Be aware of the dangers. Perhaps you don't need to make 
quite the same technical and financial investment as Industry, but by 
following these golden rules you will at least reduce the chances of 
damage: 


> Even in a small electronics lab you can ‘defuse’ the floor by 
installing a conductive floor mat with an earth connection. 

> The same applies to the work surface, on which you can fit a fairly 
cheap conductive mat. 

> A wrist strap is life insurance for sensitive components and 
should be connected to a common ground point. 

> Every decent soldering iron, even halfway professional should 
have a ground connection and tools are available with handles 
that dissipate static charge. 

> Take great care when using sharply pointed tweezers. 

> All wheeled stools, chairs, rolling cabinets or shelves should be 
fitted with conductive ESD castors. 

> Sensitive components are supplied in conductive packaging and 
should remain there right up until they are mounted. 

> Make sure there are no holes or tears in the ESD protective bags 
or storage boxes. 


A safe ESD strategy is to make sure that once a component is taken 
out of its protective packaging, it is moved as little as possible and 
of course no contact is made with any of its connection pads. Just 
by tipping out components onto a non-conductive surface can — 
worse case — generate potentially damaging levels of charge. Appro- 
priate tweezers and pliers are available for handling and mounting 
components. The investment you make in these tools will be amply 
repaid in the long run. Even though they may look cool, it’s best to 


aa WEB LINKS 
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Key words 


ESD Electrostatic Discharge 

ESA Electrostatic Area (ESD-protected zone) 

ESDS Electrostatic Discharge Sensitive 

Cleanroom A controlled environment with a low level of 
airborne pollutants such as dust and airborne 
microbes. Used for semiconductor chip 
manufacture. 

Wafer Round disk of silicon, the substrate on which 
chips are fabricated. 

Front End Chip production step; Doping the 
semiconductor wafer to produce conductive 
regions. 

Back End Chip production step; Wafer probing, dicing and 
final component test. 

HBM Electrical model of the human body (Human- 


Body Model). 


avoid wearing sports garments; these are invariably made of synthetic 
material. Choose overalls or coats designed to avoid the buildup of 
electrical charge and make sure they are buttoned up and not flapping 
about when you move. 


Pay attention to the cleanliness of the workspace; clean work surfaces, 
remove solder splashes, metal swarf and regularly clean your chair 
castors and the floor (no polish). 


The use of highly complex and miniature components in small electron- 
ics labs can be ever more frustrating and unsatisfying without the 
necessary aids to assist in component handling and circuit building. 
With any luck the information provided here will help prolong the 
life of at least one or two expensive ICs and cut down the need for 
time-consuming and exasperating fault tracing. M€ 
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Questions or Comments? 
If you have any technical questions that relate to this article please 
email the Elektor editorial team at editor@elektor.com. 
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Solar Power 
for Mowing Robots 


Ecological, Inexpensive, Simple! 
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By Dr. Thomas Scherer (Germany) 





A mowing robot is a fine thing, comfortable and practical. But ecologically there is still 
potential for optimization, because it needs electric energy all the time. Besides: Not 
everywhere you can simply lay a 230 V cable for the power supply. A suitable solar system 


solves both problems. 


Once upon a time (three years ago), when 
the neighbor's boy turned into a young 
student, he spent his time better learning 
than mowing the lawn in my garden. So 
I bought a mowing robot. This decision 
had the additional advantage that the 
lawn cuttings and thus the nutrients were 
recycled, instead of turning my compost 
heap into a compost mountain in a short 
time. After initial difficulties in laying the 
boundary and search cable to match the 
rather complex shape of the lawn, the robot 
did what it was supposed to. And if it didn't 
break, it still mows today... 


Solar operation 

Everything would have been great and the 
fairy tale would have ended here, if not 
recently my girlfriend - who has a doctor- 


ate in chemistry - teased me. It happened 
that a good friend of mine wanted to equip 
his motorboat with an electric refrigerator 
that should be powered by solar energy. As 
the “Electricus” of my clan, I was naturally 
responsible for the basic calculations of this 
solar system. And as soon as Alexandra heard 
about this, she pointed her lips and asked me 
with feigned innocence: “And why doesn't 
your lawn robot run on solar energy yet?” 


Bang! Of course I couldn't let that sit on 
me. So I quickly checked the conditions of 
this in my head, checked the Internet for 
current component prices and just half an 
hour later I told her: “It’s pretty easy to do 
and it’s also quite inexpensive. With about 
100 € you can get there!” 

She smiled skeptically, because as a 


convinced scientist, the Goethe-oriented 
operating system installed in her brain 
operates according to the motto: “The 
message well I hear, my faith alone is weak.” 
Not beautiful words count for her, but 
only deeds. So I had to prove it... 


Basic considerations 

I have a mowing robot from Gardena, which 
is an inexpensive version of the well-known 
Husquarna machines. For a lawn of approx. 
550 m?, it has to mow approx. 4 h/d during 
the growth phase - in spring and autumn, 
whereas in the dry midsummer, it will get 
there with 2 h/d or less. Fortunately, there 
is plenty of sunshine just when it is needed. 


The robot has a battery that lasts for about 
an hour of mowing. Then it has to return 
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Figure 1: The block diagram of a solar system for mowing robots with energy flow (red). 








Figure 2: Front and back of my 12 V solar panel with 80 W ca 


to its base station and after an hour of 
charging it is ready to mow again. If I want 
to let it mow for 2 h/d, I have to program 
(wireless) a window of 3 h because one hour 
of this is the charging break. 


In order to be able to estimate how much 
energy is required per charging process, 
I asked the Internet: The corresponding 
power supply unit supposedly supplies 
28 V ata maximum of1.3 A. Since HTML 
is patient, I measured it: In fact my power 
supply delivered a voltage of 28.1 V (DC) in 
non charging mode. When the robot was 
charging its battery, my clamp ammeter 
indicated a current of 1.29 A. During 
charging the voltage dropped to 26.5 V. 
“The power supply is really soft” I thought, 
which later turned out to be wrong ;-) 


Anyway: 26.5 V x 1.3 A results in about 
35 W according to Adam Ries and the 
power formula. This means that about 
35 Wh are needed per one 1 h lasting 
charge. For the four mowing phases on 
an early summer day, 140 Wh can be 
expected. This is the amount of electri- 
cal energy per day that the solar system 
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should be able to supply (and store) even 
when the sun is not shining fully. 


Added to this is the energy requirement of 
the base station, which supplies the bound- 
ary wires with a pulsed signal of decent 
strength around the clock, whose magnetic 
field is detected by the robot during opera- 
tion (see my article [1]). I measured a quies- 
cent current (non charging) of 85 mA at 28.1 
V. Consequently, about 2.4 W (= 58 Wh/d) 
are required in addition to the chargings. 


Even though these values are only valid 
for my mowing robot, the assumption is 
justified that they are more or less valid for 
most of the currently available devices. My 
robot is suitable for 1,100 m? and is there- 
fore “middle class”. Smaller robots certainly 
need less energy and larger robots need 
more. However, measuring it yourself is 
better than just guessing. 


Solar system 

If I calculate 200 days with an average 
of 3 h/d for mowing per year, I get 600 
charging cycles, which results in an annual 
energy requirement of 21 kWh. If you add 


the 2.4 W x 24 h x 200 d = 11.5 KWh to this, 
this results in electricity costs of 9.75 € (at 
30 ¢/kWh). A solar system for the assumed 
100 € would “already” have paid for itself in 
ten years. Is that worthwhile? Economically 
it may not be a hoot, but ecologically it is, 
because in this time it would have saved 
around 105 kg of CO.. In addition, you are 
independent of the mains connection 
when choosing the location for the mower's 
charging station. Thirdly Alexandra... 


The solar system for the mowing robot 
requires four components (Figure 1): In 
addition to the solar panel, a battery 
is needed to store energy, otherwise the 
mower cannot be charged when the sun 
is not shining. The latter results in the need 
for a charge controller that transfers the 
energy from the panel to the battery, taking 
into account the battery's end-of-charge 
and end-of-discharge voltages. Last but 
not least, a DC/DC converter is required 
to raise the battery voltage to the level 
required by the mower’s charging station. 
Considerations anda rough calculation are 
required for each component in order to 
dimension it adequately. All calculations 
are based on the maximum energy require- 
ment per day, which in my case is <200 Wh. 
Now to the calculations. 


Solar panel 

Ideally, the panel should deliver as much 
energy in two hours as the mower consumes 
in one hour of mowing, taking into account 
the one-hour charging break. Calculating 
15 % losses due to charge controller and DC/ 
DC converter, one arrives at around 40 W 
per 2h = 20 W continuous power during the 
time the mower is mowing (and charging). 
Then the battery usually remains full ifthe 
sun is shining. Since the power output of 
solar panels is measured in W sa and you 
will rarely have optimal conditions without 
shading and an ideal panel inclination, 
doubling the power output is certainly not 
wrong. Is a panel with 40 W ea sufficient? 
Not in my opinion, as the sun shines very 
obliquely in spring and autumn, this would 
still be a very optimistic interpretation. 
Another safety factor of 2 is certainly not 
exaggerated. So 80 W eax in my case is the 
minimum. I ordered such a panel on eBay 
for 55 € (Figure 2), because it had - what 
a coincidence! - with 77 x 66,5 cm exactly 
the right dimensions to serve as a roof 
for the doghouse, which I converted into 
a mower garage. 


Measurements showed that at the end 
of October in southern Baden (Germany) 
around midday, when mounted horizon- 
tally, a power output of about 22 W can be 
expected. The rough calculation was correct! 


Battery 

The energy storage should be sufficient 
for at least one day of dense cloud cover. 
It must therefore be able to store 2140 Wh. 
An AGM 12 V lead-acid battery with 12 Ah 
=~ 150 Wh costs around €25 on eBay. AGM 
is necessary to achieve as many charging 
cycles as possible in this application and 
thus a long life. An 80 W panel delivers 
a peak current of just under 6 A. So the 
battery is charged with a maximum of 
0.5 C (usually less; see Box Currents in C), 
which is good for durability. It is discharged 
at about 40 W, which corresponds to 0.25 C. 
Since there are also many short partial 
charge cycles, one can justifiably expect 
years of operation. A12 Ah battery is the 
minimum for this application - more would 
be better - but I wanted to try it with the 
calculated minimum and therefore ordered 
the battery shown in Figure 3). 


Solar charge controller 

The market is flooded with masses of 
inexpensive small power charge control- 
lers, which are suitable for my purposes. 
I decided to buy a relatively “expensive” 
regulator for 13,50 €, because it has a metal 
housing and cooling fins on the back. 
Perhaps exaggerated, as my system uses 
only 20 % of the possible 30 A. 
Inexpensive units all work with simple PWM 
control, which is not quite optimal. If you 
want a better MPPT controller (Maximum 
Power Point Tracking) for best efficiency, 
you have to pay at least €75. In order to stay 
below the projected 100 €, I decided to use 
the cheap version of Figure 4. 


DC/DC converter 

First I thought that a 24 V solar system 
with two 12 V batteries connected in 
series would be the simpler solution. The 
mower’s charging station probably works 
well with 24 V, even if it is specified for 28 V. 
This would save a step-up converter, which 
otherwise is needed for boosting the operat- 
ing voltage from a 12 V battery, addition- 
ally eliminating the conversion loss and 
the quiescent current of the converter. 
However, 24 V solar panels are more expen- 
sive. What became apparent later, I was 
lucky opting for the 12 V technology. 
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Figure 3: The 12 V AGM lead battery with 12 Ah. 


So a step-up converter of sufficient power 
had to be found, which brings the 12...14 V 
of the battery to the required 28 V. It should 
be able to deliver at least 40 W. On the 
Internet you can find suitable modules 
in abundance. I decided to buy a150 W 
module for just under €10, which promised 
sufficient reserves. Figure 5 shows the 
modified version built into a plastic case. 
An efficiency of 95 % is promised. And that 
was true, as my measurements showed. 
This is no wonder, because the type UC3843 
is certainly not a bad choice for IC1. 


Allin all, I spent €55 + €25 + €13.5 + €10 = 
103.50 € - quite a good guess, isn’t it? On 
top of that I had to spend a few euros for 
small parts, stainless steel screws, hinges, 
and the plastic housing. 


Conversion with obstacles 

First came the mechanical work, which 
was unloved by my electronic heart: The 
conversion of the previous housing of the 
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Figure 4: This cheap solar charge controller in 
PWM technology tolerates currents up to 30 A. 





Figure 5: A simple step-up converter has been 
extended by a current limiter of 1.3 A. 





Figure 6: The four stages of converting a misused doghouse into a solar garage for my mowing robot. 
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Figure 7: How to lock the panel against wind. 





Figure 9: Original and modified (partial) circuit of 
the step-up converter. 





Figure 10: All finished: solar garage with built-in 
electronics. 
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Figure 8: Back side of the board of the step-up 
converter. 


base station into a garage with a solar roof. 
The four partial pictures of Figure 6 illus- 
trate the procedure. 


First the two halves of the roof (a) were 
removed and the gables were sawn off as 
shown in (b). Then aluminum angle profiles 
were used to stabilize the now somewhat 
wobbly rest, and finally the solar panel was 
attached in a hinged manner (c). Stainless 
steel is not exaggerated in hinges and 
screws, if you want to prevent rusting. In 
(d) you can see the folded up result with 
the mower parked. Figure 7 shows how I 
have locked the panel windproof, which is 
an absolute must. 


The next step has already been more inter- 
esting: Finally the battery, charge control- 
ler and boost converter were installed 
and wired. And immediately the LED of 
the charging station turned green, even 
though I had set the converter to only 27 V, 
considering the voltage drop of the original 
power supply. So at first everything seemed 
to work and the mowing robot actually 
recognized the installed boundary wires 
and happily mowed along. 


To see if it was charging nicely, I then 
pushed the mower into its charging station. 
My smartphone was already “pinging” as 
the mower app received an error message 
from the mower... 

Displayed was: “Charging current too high:”, 


Oh! “That can make a big mess!” I thought 
to myself and quickly pulled the mower 
out of the charging station. In the evening 
Alexandra asked “Did everything work out 
with your mower?” [had to admit a status 


report in the style of Radio Yerevan: “In 
principle yes, but...”. 


I told her that the idle mode works fine, 
but the error message was not that funny. 
But I would have a suspicion that the 
robot relies on the fact that its power 
supply has a built-in current limiter, and 
therefore simply charges with a constant 
current. Tomorrow I would measure the 
power supply and if necessary, I would 
retrofit the boost converter with a current 
limiter or build an extra mimic for it. 
IfI had connected 24 V from batteries 
without current limiter directly, there 
would have been smoke clouds. Lucky 
in misfortune. 


Current limitation 

The next day it turned out that my assump- 
tion was correct. At a load of 24 Q the origi- 
nal power supply delivered a current of 1.17 
A at stable 28.05 V. With a load of 12 OQ I 
could only measure 15.5 V. The current was 
1.29 A. A retest with 15 Q resulted in 19.4 V 
at stable 1.29 A. So this was a 28 V power 
supply with a built-in current limiter of 
about 1.3 A. 


Now I took a closer look at the converter’s 
circuit board (Figure 8) and extracted the 
circuit as far as necessary. The upper half 
of Figure 9 shows the original circuit. The 
lower half shows my modifications in red. 


The output voltage is adjusted by IC1 so 
that its input VFB gets a voltage of 2.5 V 
applied. It is adjustable with P1 between 
U, and 34 V. The output voltage of this type 
of converter cannot be smaller than at the 
input, because even when the conversion 
is switched off, current flows through L1 
and D1 to the output. But ifthe voltage at 
the output can vary between 14 V and 28 V, 
that is enough, I thought. So you just had to 
loop in a shunt resistor (R6) and to increase 
the voltage at pin VFB in case of overload by 
a PNP transistor, for reducing the voltage 
at the output. 


First I replaced P1 with a fixed resistor of 
6.8 kQ. This resulted in 27 V - fits. Then 
the input current sensor R1 was replaced by 
higher resistive 0.22 Q (SMD 2512), because 
150 W are not necessary at all. With 0.47 Q 
for R6 anda BE voltage of about 650 mV of 
the additional T2, a current limitation of 
1.38 A can be expected, which would fit. 
So I installed the red components (T2, R7 





Figure 11: A 3.5 mm jack plug (a) contains a 
diode (b) as temperature sensor. On the right 
side (c) it is waterproof sealed with hot glue. 


and R8 directly on the bottom side of the 
board) and pulled out the ammeter: exactly 
1.30 A. Hit! 


All's well that ends well! 

I put the modified converter back into its 
housing, placed it back into the garage of 
the mower (Figure 10), and switched it on: 
The green LED of the charging station lit 
up and Tadaah: When I pushed the mower 
in, there was no more error message. The 
charge controller indicated that about 37 W 
were heading towards the mowing robot. 
What more did I want? 


Before I triumphantly reported my success 
to Alexandra, I had the mower mowing and 
charging several times. No more problems 
arose. 


And in case you are wondering what 
happens if it rains for a week in autumn 
or spring - this question is justified: With 
a mowing time of 2 h/d, the battery lasts 
just 1.5 to 2.5 days, then it is empty and 
the mower stays in the garage until the 
sun shines sufficiently. Light cloud cover 
is sufficient for it to wake up again. If 


you want more reserve, the battery and 
possibly the panel must be dimensioned 
larger. A100 W panel and a 20 Ah battery 
is certainly not an exaggerated waste. The 
charge controller and also the converter 
can tolerate much higher power. 


Winter is no problem, by the way, because 
that's when the mower (including battery) 
moves from its garage into my garage. 


Addendum 

The voltages of a lead battery have a 
temperature response. Consequently, 
some charge controllers have a tempera- 
ture sensor to take this into account. My 
charge controller had an apparently empty 
3.5 mm jack plug enclosed (Figure 11a). 
When unscrewing the cover a simple 
silicon diode appeared (b). Clearly, a PN 
junction has a temperature coefficient of 
about -1.7 mV K, and that is sufficient. But 
the primitive construction was not a good 
idea because of possible humidity and small 
animals looking for shelter. Therefore I cut 
off the bend protection and simply filled 
the grommet with hot glue (c). Now it is 
water- and animal-proof. 


CURRENTS INC 





If you have something similar in mind: 
There are also ready-made step-up/down 
or boost/buck converters with adjustable 
current limiter for only a few Euros extra. So 
you can avoid the modificationImade. K 
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Questions or Comments? 

Do you have questions or comments 
about this article? Then email Elektor 
at editor@elektor.com. 


Contributors 

Idea, Implementation and Text: 

Dr. Thomas Scherer 

Editors: Jens Nickel and CJ Abate 
Layout: Giel Dols 


For rechargeable batteries the relative charge or discharge current is given in the 


=—— WEB LINK 


commonly used 'non-SI unit’ C - the fraction of capacity by time (current / capactity). 
A C of 0.5 results in a current of 6 A for a 12 Ah battery. The advantage of the unit C is 
that it indicates the stress of the battery. Batteries are designed for certain maximum 
C values. The higher the real C-values, the shorter their life. 

=> for a given current, larger batteries live longer. 


RELATED PRODUCTS 





> USB Solar Panel Battery Regulator 
www.elektor.com/usb-solar-panel-battery-regulator-charge-intelligent-controller-12-24-v-10-a 


> PeakTech 4350 Clamp Meter 
www.elektor.com/peaktech-4350-clamp-meter 


> OWON OW16B Digital Multimeter with Bluetooth 
www.elektor.com/owon-ow16b-digital-multimeter-with-bluetooth 





[1] Elektor article “Locating Wayward Wires”: 
www.elektormagazine.com/magazine/elektor-141/57129 
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/ (lektorstore \ 


C a www.elektor.com 


The Elektor Store 


Never expensive, always surprising 


The Elektor Store has developed from the that we ourselves are enthusiastic about or that 
community store for Elektor’s own products we simply want to try out. If you have a nice 

like books, magazines, kits and modules, into suggestion, we are here (sale@elektor.com). 

a mature webshop that offers great value for Our main conditions: 

surprising electronics. We offer the products never expensive, always surprising! 


Creality Ender-3 V2 
5D Printer 


Price: €259.00 
Member Price: €233.10 


W www.elektor.com/19744 











Price: €29.95 
Member Price: €26.96 





 www.elektor.com/19754 
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Raspberry Pi Pico 
solAaevea on hoord 


Cytron Maker Pi Pico 
(incl. Raspberry Pi Pico RP2040) 


Price: €19.95 
Member Price: €17.96 


 www.elektor.com/19706 








The Complete Linear Audio Library 
(USB Stick) 


Price: €149.95 
Member Price: €89.95 


E www.elektor.com/19672 














Pat 
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Andonstar AD409 Digital Microscope 
with 10.1" LCD Screen 


Price: €399.00 
Member Price: €359.10 


E www.elektor.com/19681 





@lektor! 


Getting Started 
with ESPHome 





Getting Started with ESPHome 


Price: €29.95 
Member Price: €26.96 


E www.elektor.com/19738 
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urope's Efforts 


to Tame Big Tech 


By Tessel Renzenbrink (The Netherlands) 


The European Commission (EC) is working toward a 
human-centered Internet where users’ fundamental 
rights are respected, as well as a digital single market 
with a level playing field. Is it possible, or will Big Tech 


go untamed? 


Europe wants its Internet back. It is attempt- 
ing to pry power over the digital sphere out 
of the clutches of Big Tech companies. As 
part of its strategy for the EU's digital future, 
the European Commission (EC) strives fora 
digital space based on European values — 
a human-centered Internet where people's 
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fundamental rights are respected, anda 
digital single market with a level playing 
field. To accomplish that, the EC is working 
on new laws to regulate the digital space. 
A key piece of legislation is the Digital 
Services Act package, which was proposed 
last December. 


The package consists of two legisla- 
tive initiatives: the Digital Services Act 
(DSA), which aims to protect citizens and 
their fundamental rights online, and the 
Digital Markets Act (DMA), which aims 
to rein in the significant power of ‘very 
large online platforms’ or ‘gatekeepers’. 
The package introduces a scaled respon- 
sibility scheme based on a company’s size. 
The first tier consists of small companies. 
They have the least responsibilities to limit 
their regulatory burden. The second tier is 
reserved for large platforms. The third tier 
includes the very large online platforms like 
Facebook and Google. They are designated 
as gatekeepers because they serve as an 
important gateway between businesses and 


customers. This gives them the power to set 
rules that disadvantage other businesses 
and can lead to unfair competition. That is 
why the proposal assigns the most respon- 
sibilities to them. A platform is considered 
a gatekeeper if it serves at least 10% of the 
EU's population. 


The Digital Service Act 

One of the issues the DSA seeks to address 
is the spread of illegal content, such as hate 
speech, revenge porn and the offering of 
counterfeit goods. Under the proposed 
law, both member state authorities and 
citizens receive more control to alert digital 
service providers about such illegal content. 
Service providers must put user-friendly 
mechanisms in place that enable anyone 
to flag content deemed illegal. The provider 
must process the notification swiftly and 
inform the flagger about its decision on how 
it will handle the content. If the decision 
is made by an automated process, that too 
must be communicated to the flagger. They 
must also appoint a natural person within 
their company serving as a point of contact 
for member state authorities. 


It is not without risk to oblige online 
platforms to remove illegal content and 
hold them accountable if they don't. It 
can incentivize a better-safe-than-sorry 
attitude and lead to the over-removal of 
content. Digital rights organizations have 
pointed out the danger of making private 
companies the de facto arbiters of what 
can be expressed online. It infringes on the 
fundamental rights of freedom of speech 
and right to information. To counteract 
overly ambitious content removal, the DSA 
retains two core principles laid down in the 
e-Commerce Directive, the legal framework 
that has governed the European internet 
since 2000. These core principles are the 
Limited Liability Regime and the Prohibi- 
tion of a General Monitoring Obligation. 
The former states that platforms can't be 
held liable for user-generated content 
unless they have ‘actual knowledge’ that 
the content is illegal. The latter states that 
platforms can’t be compelled to perform 
a blanket monitoring of their systems in 
order to identify illegal content. 


The DSA introduces more safeguards to 
protect users against unwarranted content 
removal or being kicked off a platform 
without proper cause. Service providers 
must inform users about removals and 
provide the reason why. Large platforms 
must provide an internal complaint-han- 
dling procedure so users can contest the 
decision (small businesses are exempted 
from this obligation). Large platforms must 





In its fight for power 
with Big Tech, the EC 
is bringing out the 
big guns. Penalties for 
breaking the law can be 
severe. 


also arrange for dispute resolution mecha- 
nisms overseen by an independent body. 


The DSA seeks to shift the power balance 
between platforms and society more 
towards the latter by introducing trans- 
parency rules. Currently, many platforms 
collect a lot of data about their users, while 
users know very little about how platforms 
operate. Under the DSA, large platforms 
must become more open about targeted 
advertising. Users must be notified which 
company or person is directing the ad at 
them and why the ad is targeted at them. 
Large platforms must also become more 
open about their recommendation systems. 
They must clearly explain to users the main 
parameters they use for recommending 
content. Users also get the right to alter 
those parameters or completely opt-out 
of the recommendation system. 





The Digital Markets Act 

The DMA applies specifically to gatekeep- 
ers and aims to create a level playing field 
in the digital market. To that end, the DMA 
proposes that very big online platforms 
cannot favor their own products over 
that of competitors (e.g., Google listing its 
own services at the top of its search engine 
results). Data of businesses will be better 
protected: businesses must be allowed to 
access the data they have generated on the 
gatekeeper’s platform. They must also be 
allowed to take their data out of the ecosys- 
tem to host it elsewhere. The gatekeeper 
is not allowed to use that data to compete 
with the business. The gatekeeper is also no 
longer allowed to impose its intermediary 
status: when consumers and businesses 
want to link up outside the platform, the 
gatekeeper may no longer prevent it. 


In its fight for power with Big Tech, the EC 
is bringing out the big guns. Penalties for 
breaking the law can be severe. Gatekeepers 
that don't comply with the DSA can be fined 
up to 6% of their annual turn-over. In case 
of continued non-compliance, they can 
be forced to temporary suspend all activi- 
ties on the European networks. The fines 
for breaking the DMA are even higher at 
10% of annual turn-over. Continued rogue 
behavior can be penalized with a manda- 
tory breakup of the company. 


The Digital Services Act package is 
currently going through the EU's legisla- 
tive process. The EC, European Parliament 
and the Member States all must agree on 
the final text before it is adopted. M€ 
210177-01 





EU flags at the European Commission 
Berlaymont building. (Photo by Guillaume 
Périgois via Unsplash) 
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HEXADOKU 





Hexadoku The Original Elektorized Sudoku 


Traditionally, the last page of Elektor magazine is reserved for our puzzle with an electronics 
slant: welcome to Hexadoku! Find the solution in the gray boxes, submit it to us by email, 
and you automatically enter the prize draw for one of five Elektor store vouchers. 


The Hexadoku puzzle employs numbers in the hexadecimalrangeo are given inthe puzzle and these determine the start situation. 
through E In the diagram composed of 16 x 16 boxes, enter numbers 

such that all hexadecimal numbers o through F (that’s o-9and A-F) Correct entries received enter a prize draw. All you need to do is 
occur once only in each row, onceineachcolumnandineachofthe send us the numbers in the gray boxes. 

4x4 boxes (marked by the thicker black lines). A number of clues 


SOLVE HEXADOKU AND WIN! PARTICIPATE! 


Elektor Stor 





Correct solutions received from Ultimately August 16th, 2021, 
the entire Elektor readership supply your name, street address 
automatically enter a prize draw and the solution (the numbers in the 
for five Elektor store vouchers gray boxes) by email to: 
en worth €50.00 each, which should hexadoku@elektor.com 
e ae ye! ahs — encourage all Elektor readers to 
~~ participate. 
PRIZE WINNERS 


The solution of Hexadoku in edition 5-6/2021 (May & June) is: F9E18. 
Solutions submitted to us before June 14th were entered in a prize draw for 5 Elektor Store Vouchers. 
The winners are posted at www.elektormagazine.com/hexadoku. 


Congratulations everyone! 
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